What's Included
- Complete Recursive Companion framework for self-improving AI agents
- Three-phase engine (Draft → Critique → Revision) with automatic iteration
- Four pre-built companions: Generic, Marketing, BugTriage, Strategy
- Hot-swappable template system - modify prompts without code change
- Multi-agent demos for both raw Python and extension with other frameworks
- Full documentation, docstrings, and architecture guides
Key Features
- Complete thinking transparency - inspect every iteration
- Works as Python callables anywhere
- Framework-agnostic - compatible with LangGraph, notebooks, APIs
- Extensible via text templates (no code changes needed)
Key Components
- core/chains.py - Main engine with BaseCompanion class
- templates/ - Modular prompt system with protocol injection
- recursive_companion/base.py - Ready-to-use domain companions
Streamlit App (optional)
- Live visualization of critique/revision cycles
- Test different models and parameters
- Template viewer included (updated on reload)
Installation
pip install -e . # Core functionality
pip install -e .[all] # Includes Streamlit app and demos
Requirements
- Python ≥3.11
- OpenAI API key
- See pyproject.toml for full dependencies