Update README.md to enhance project overview, features, and setup instructions for Project Management Agency Swarm demo

README.md

@@ -1,3 +1,94 @@
-# Overview
+---
+title: Project Management Agency Swarm Demo
+emoji: 🐝
+colorFrom: yellow
+colorTo: black
+sdk: gradio
+sdk_version: "5.19.0"
+app_file: app.py
+pinned: false
+---
 
-Private demo for Technical Project Manager job application @ Agency AI (creator of the Agency Swarm framework)
+# 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/demo.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/