README.md

metadata

title: FloorManager
emoji: 📚
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 6.2.0
app_file: test_app.py
pinned: false
license: apache-2.0
short_description: Minimal functional floor manager

OpenFloor Protocol (OFP) Floor Manager

A Python implementation of the OpenFloor Protocol Floor Manager with Gradio UI for managing multi-agent conversations.

Project Status

✅ Completed

• Project structure created
• Configuration management (settings.py)
• Logging infrastructure
• Helper utilities
• Basic protocol envelope handling
• Requirements file with all dependencies

🚧 In Progress

• Protocol events module (has syntax errors that need manual fixing)
• Protocol handler
• Core business logic (FloorManager, FloorSession, Agent, Convener)

📋 Todo

• FastAPI backend endpoints
• Gradio UI implementation
• Example agents
• Integration testing
• Documentation

Installation

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On macOS/Linux
# or
venv\Scripts\activate  # On Windows

# Install dependencies
pip install -r requirements.txt

# Install OpenFloor SDK from test PyPI
pip install -i https://test.pypi.org/simple/ openfloor

Architecture

The project follows a modular architecture:

ofpFloor/
├── src/
│   ├── utils/          # Configuration, logging, helpers
│   ├── protocol/       # OFP protocol implementation
│   ├── core/           # Business logic (Floor Manager, Sessions, Agents)
│   ├── api/            # FastAPI endpoints
│   └── ui/             # Gradio interface
├── tests/              # Unit and integration tests
└── examples/           # Example agents and scenarios

Known Issues

Syntax Errors in src/protocol/events.py

The file has Python syntax errors that need to be manually fixed:

1. Line 9: event_ Dict[str, Any] should be event_ Dict[str, Any]
2. Line 10: meta Optional[Dict[str, Any]] should be meta Optional[Dict[str, Any]]
3. Line 30: if meta should be if meta

These need to be fixed before the project can run.

Next Steps

1. Fix syntax errors in src/protocol/events.py
2. Complete protocol handler implementation
3. Implement core Floor Manager logic
4. Create FastAPI endpoints
5. Build Gradio UI
6. Test with example agents

References

• OpenFloor Protocol Specifications
• OFP Assistant Manifest
• OFP Inter-Agent Message
• OFP Dialog Event Object
• Gradio Documentation

License

MIT License