A production-ready template for deploying Agency Swarm agencies with Docker containerization and automated deployment to the Agencii cloud platform.

🌐 Agencii - The official cloud platform for Agency Swarm deployments
🔗 GitHub App - Automated deployment integration

Click "Use this template" to create your own repository, or:

git clone https://github.com/your-username/agency-github-template.git
cd agency-github-template

🌐 For Production: Sign up at agencii.ai and use this template for automated cloud deployment

pip install -r requirements.txt

Create a .env file in the root directory:

# Required
OPENAI_API_KEY=your_openai_api_key_here

# Optional - Add any additional API keys your agents need
# EXAMPLE_API_KEY=your_api_key_here

python agency.py

This runs the example agency in terminal mode for testing.

💡 Pro Tip: For creating your own agency, open this template in Cursor IDE and use the AI assistant with the .cursor/rules/workflow.mdc file for automated agency creation!

agency-github-template/
├── agency.py                 # Main entry point
├── requirements.txt          # Python dependencies
├── Dockerfile               # Container configuration
├── .env                     # Environment variables (create this)
├── example_agent/           # Your agency folder
    ├── __init__.py
    ├── example_agent.py
    ├── instructions.md
    ├── files/               # Local files accessible to the agent (via files_folder)
    └── tools/
        └── ExampleTool.py
├── example_agent2/
├── agency_manifesto.md  # Shared instructions
├── requirements.txt
├── .env
└──...

This template includes AI-powered agency creation using Cursor IDE:

1. Open this project in Cursor IDE

2. Use the AI Assistant to create your agency by referencing:

   📁 .cursor/rules/workflow.mdc
   

3. Simply ask the AI:

   "Create a new agency using the .cursor workflow"

   The AI will guide you through the complete 7-step process:

   • ✅ PRD Creation
   • ✅ Folder Structure Setup
   • ✅ Tool Development
   • ✅ Agent Creation
   • ✅ Agency Configuration
   • ✅ Testing & Validation
   • ✅ Iteration & Refinement

The AI assistant will automatically:

• Create proper folder structures
• Generate agent classes and instructions
• Build custom tools with full functionality
• Set up communication flows
• Create the main agency file
• Test everything to ensure it works

If you prefer manual setup, replace the ExampleAgency/ folder with your own agency structure following the Agency Swarm conventions.

Your agency must follow this structure:

• Agency Folder: Contains all agents and manifesto
• Agent Folders: Each agent has its own folder with:
  • AgentName.py - Agent class definition
  • instructions.md - Agent-specific instructions
  • tools/ - Folder containing agent tools
• agency_manifesto.md - Shared instructions for all agents

For production deployment, use the Agencii platform:

1. Sign up at agencii.ai
2. Use this template to create your repository
3. Develop your agency using Cursor IDE with .cursor workflow

1. Install the Agencii GitHub App
2. Grant permissions to your repository
3. Configure environment variables in Agencii dashboard

1. Push to main branch - Agencii automatically detects and deploys
2. Monitor deployment in your Agencii dashboard
3. Access your live agency via provided endpoints

• Auto-deploy on every push to main branch
• Zero-downtime deployments with rollback capability
• Environment management through Agencii dashboard

1. Open Cursor IDE with this template
2. Ask the AI: "Create a new agency using the .cursor workflow"
3. Follow the guided process - the AI handles everything automatically
4. Test your agency: python agency.py
5. Deploy to production: Install Agencii GitHub App and push to main

If you prefer hands-on development:

1. Create Tools: Build agent tools in tools/ folders
2. Configure Agents: Write instructions.md and agent classes
3. Test Locally: Run python agency.py
4. Deploy: Push to your preferred platform

The .cursor/rules/workflow.mdc file contains the complete development specifications for manual implementation.

• 🌐 Agencii Cloud Deploy: One-click deployment to Agencii platform
• 🤖 AI-Assisted Creation: Built-in Cursor IDE workflow for automated agency development
• 🔄 Auto-Deploy: Automatic deployment on push to main branch
• 🚀 Ready-to-Deploy: Dockerfile and requirements included
• 🔧 Modular Structure: Easy to customize and extend
• 🛠️ Example Implementation: Complete working example
• 📦 Container Ready: Docker configuration for any platform
• 🔒 Environment Management: Secure API key handling via Agencii dashboard
• 🧪 Local Testing: Terminal demo for development
• 📋 Guided Workflow: 7-step process with AI assistance

• Agency Swarm Documentation
• Agency Swarm GitHub

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

• Start Small: Begin with 1-2 agents and expand
• Test Tools: Each tool should work independently
• Clear Instructions: Write detailed agent instructions
• Environment Setup: Always use .env for API keys
• Documentation: Update instructions as you develop

Ready to build your AI agency? 🤖✨

1. Sign up at agencii.ai
2. Use this template to create your repository
3. Install Agencii GitHub App
4. Push to main → Automatic deployment!

Open this template in Cursor IDE and ask the AI to create your agency using the .cursor workflow. The AI will handle everything from setup to testing automatically!

For manual development, replace the ExampleAgency with your own implementation and start deploying intelligent agent systems!