An intelligent multi-agent platform for analyzing software project requirements, generating technical specifications, and delivering project strategies — powered by OpenAI agents working in synergy.

AI Services Agency is your all-in-one virtual consultancy powered by AI. It brings together a team of specialized agents — CEO, CTO, Product Manager, Developer, and Client Manager — who collaborate to evaluate your project idea and deliver:

✅ Project Analysis
✅ Technical Specifications
✅ Product Roadmap
✅ Development Plan
✅ Go-to-Market Strategy

• 🧠 Multi-agent collaboration via Agency Swarm
• 📊 Project intake form with budget, timeline, and requirements
• 🔍 Automated analysis of project feasibility
• 🏗️ Generation of technical architecture specs
• 🧭 Product strategy insights and developer planning
• 🌐 Go-to-market plan for client delivery success
• 🔒 OpenAI API integration with token security
• 🖥️ Built with Streamlit for rapid deployment

📦 ai-services-agency/
├── 📁 agents/        # 🤖 Definitions for each specialized AI agent
│   ├── ceo.py               # 🧑‍💼 CEO – Strategic project analysis
│   ├── cto.py               # 🛠️ CTO – Technical architecture and specs
│   ├── developer.py         # 👨‍💻 Lead Developer – Implementation planning
│   ├── product_manager.py   # 📈 Product Manager – Roadmap and features
│   └── client_manager.py    # 💼 Client Success Manager – GTM strategy
│
├── 📁 tools/         # 🧰 Tools used by agents
│   ├── analyze_project.py       # 📊 Analyze project requirements
│   └── create_specification.py  # 📐 Create technical specification
│
├── 📁 core/          # 🔧 Core app logic and shared session
│   └── session.py           # 🧠 Session state initialization
│
├── 📄 app.py             # 🚀 Main Streamlit app – UI + Agent Orchestration
├── 📄 requirements.txt   # 📜 dependencies
├── 📄 LICENSE            # 📝 MIT License.
└── 📄 README.md          # 📘 Project documentation

git clone https://github.com/andredisa/AI_services_agency.git
cd AI-services-agency

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

pip install -r requirements.txt

You’ll be prompted to enter it in the sidebar the first time you run the app.

Start by completing a simple form with essential information:

📝 Name · 🧩 Description · 🛠️ Type
🗓️ Timeline · 💰 Budget · 🔧 Technical Needs

Once submitted, a squad of expert AI agents gets to work behind the scenes:

• 🧑‍💼 CEO (Project Director)
  ➤ Provides high-level strategic analysis and project feasibility

• 🛠️ CTO (Technical Architect)
  ➤ Defines architecture and selects core technologies

• 📈 Product Manager
  ➤ Suggests product roadmap, features, and delivery strategy

• 👨‍💻 Lead Developer
  ➤ Plans the technical implementation and development flow

• 💼 Client Success Manager
  ➤ Proposes a go-to-market and customer success plan

Everything is auto-organized into interactive tabs:

🔍 View Strategic Analysis
🧱 Read the Technical Specification
📅 Explore the Product Roadmap
🚀 Plan Your GTM Strategy

All in one clean, collaborative workspace.

• 🔗 OpenAI GPT Agents – for intelligent decision-making
• 🧠 Agency Swarm – multi-agent orchestration framework
• 📺 Streamlit – to power the sleek and interactive frontend

• ✅ Requires a valid OpenAI API key with access to GPT-4 or higher
• 📦 Agent memory and shared state ensure consistent and sequential logic
• 🧪 This is a prototype — simple, extensible, and ready for your creative ideas!

Here are some cool things we’d love to add (but aren’t built in... yet 😉):

• 🧠 Persistent memory across sessions
• 📄 Exportable PDF reports of agent output
• 🧑‍🎨 Custom personas for specific industries
• 👥 Team collaboration & commenting dashboard

🎉 Contributions are more than welcome!

If you find a bug 🐞, have a feature request ✨, or want to improve the code 💻:

• Open an Issue
• Submit a Pull Request 🚀

💬 Feel free to reach out on GitHub or by email!

Let’s build this together!

📄 This project is released under the MIT License.
Please refer to the LICENSE file for full details.

If you find my work useful and would like to support me, you can buy me a coffee! Your support helps me keep creating and improving my projects. Thank you! 😊