Skip to main content
Use these production-ready templates to start faster. Pick one below and follow the steps to run locally, then customize.

Agency Starter Template

Agencii-compatible production template with Docker config and Cursor workflow guidance.

Agency Code

Agency Code example repository you can explore or customize after cloning.
Watch the Agency Code walkthrough for an overview of that repository before you customize it.

​
Use a Template

1

Choose a template

Select the Agency Starter Template when you need the Agencii-compatible setup with Docker. Use Agency Code when you want to experiment with or extend that example repository.
2

Clone the repository

Clone your chosen template repository to your local machine.
git clone https://github.com/agency-ai-solutions/agency-starter-template.git
cd agency-starter-template
3

Install dependencies

Create a virtual environment and install dependencies (Python 3.12+ recommended, 3.13 preferred).
python -m venv venv
source venv/bin/activate
python -m pip install -r requirements.txt
4

Configure environment

Create a .env file in the project root with your keys. At minimum:
OPENAI_API_KEY=sk-...
5

Run the demo

Start the terminal demo to verify the setup.
python agency.py
6

Customize agents and tools

Modify agent instructions, add or edit tools, and adjust communication flows. Refer to From Scratch for deeper explanations and code structure.

​
Next Steps