Thank you for your interest in contributing to Rooms. We welcome contributions from the community to help make this framework even better for local-first multi-agent orchestration.
Use the Bug Report template to describe the issue. Provide clear steps to reproduce the bug and include information about your environment (OS, Python version, Local LLM provider).
Use the Feature Request template. Explain the motivation behind the suggestion and how it benefits the framework.
- Fork the Repository: Create your own branch from
main. - Implement Changes: Follow the project's coding style and naming conventions.
- Run Tests: Ensure all existing tests pass by running:
$env:PYTHONPATH="."; python -m pytest tests/ -v
- Add Tests: If you are adding new logic, please include corresponding tests in
tests/test_session.py. - Submit PR: Provide a clear description of what the PR changes and why.
Local-First Always favor solutions that respect user privacy and offline execution.
Aesthetic Excellence All CLI and documentation updates should prioritize a premium, modern feel.
Zero-Leakage Be cautious with third-party integrations that might leak data.
Every push and Pull Request is automatically verified by our GitHub Actions CI/CD pipeline, which runs:
- Style Checks: Code formatting and linting via
flake8. - Logic Verification: Full suite of
pytestunit tests for turn orchestration, expertise scoring, and session memory.
Ensure your changes pass locally before submitting to maintain the build status.
Check our GitHub Issues to see what we are currently working on.
