README.md

---
title: Project Management Agency Swarm Demo
emoji: 🐝
colorFrom: yellow
colorTo: indigo
sdk: gradio
sdk_version: "5.19.0"
app_file: app.py
pinned: false
---

# Project Management Agency Swarm Demo

## Overview

This project is a practical demonstration of a Technical Project Management system built with Agency Swarm framework for a Technical Project Manager job application at Agency AI. The demo showcases how AI agents can collaborate to manage software development projects effectively.

## Features

- Multi-agent system with specialized roles:

  - Technical Project Manager - Coordinates project management activities
  - Browsing Agent - Handles web search and information gathering
  - Devid - Provides development support and guidance

- Notion integration for project management
- One way WhatsApp integration for communication
- Web browsing and search
- Code execution

## Project Structure

```
agency_swarm_demo/
├── app/                     # Main application code
│   ├── agents/              # AI agent definitions
│   │   ├── TechnicalProjectManager/
│   │   ├── BrowsingAgent/
│   │   └── Devid/
│   ├── shared_files/        # Resources shared between agents
│   ├── demo.py              # Main demo application with Gradio interface
├── requirements.txt         # Python dependencies
└── .env.example             # Example environment variables template
```

## Technology Stack

- **Python**: Base programming language
- **Agency Swarm** (>= 0.4.4): Multi-agent orchestration framework
- **OpenAI API**: Backend for agent intelligence
- **Gradio** (5.19.0): Web interface for demonstrations
- **Selenium**: For web automation capabilities

## Getting Started

1. Clone this repository
2. Copy `.env.example` to `.env` and add your API keys
3. Install dependencies:
   ```
   pip install -r requirements.txt
   ```
   or using Poetry:
   ```
   poetry install
   poetry shell
   ```
4. Run the demo:
   ```
   gradio app.py
   ```
   or simply:
   ```
   python app.py
   ```

## Purpose

This demo showcases how AI agents can be leveraged for technical project management tasks, including:

- Project planning and coordination
- Requirements gathering and analysis
- Technical research and information retrieval
- Team communication and updates
- Development guidance and support

The system demonstrates the potential for AI-augmented project management to streamline software development workflows and improve team collaboration.

## License

MIT

## Author

**João Morossini**

- Professional Portfolio: https://joaomorossini.github.io/
- GitHub: https://github.com/joaomorossini
- LinkedIn: https://www.linkedin.com/in/joaomorossini/