https://github.com/turtir-ai/kairos-context-keeper
Kairos: An autonomous development supervisor powered by Context Engineering. It provides a living memory and a contextual constitution for your projects to prevent AI context loss.
https://github.com/turtir-ai/kairos-context-keeper
agentic-ai ai ai-assistant autonomous-agents code-generation context-engineering cursor-ide developer-tools docker fine-tuning hackathon kiro-ide llm llms local-llm nlp ollama python rag retrieval-augmented-generation
Last synced: 2 months ago
JSON representation
Kairos: An autonomous development supervisor powered by Context Engineering. It provides a living memory and a contextual constitution for your projects to prevent AI context loss.
- Host: GitHub
- URL: https://github.com/turtir-ai/kairos-context-keeper
- Owner: turtir-ai
- License: mit
- Created: 2025-07-21T13:36:28.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-07-28T19:31:00.000Z (2 months ago)
- Last Synced: 2025-07-28T20:39:56.448Z (2 months ago)
- Topics: agentic-ai, ai, ai-assistant, autonomous-agents, code-generation, context-engineering, cursor-ide, developer-tools, docker, fine-tuning, hackathon, kiro-ide, llm, llms, local-llm, nlp, ollama, python, rag, retrieval-augmented-generation
- Language: Python
- Homepage: https://turtir-ai.github.io/kairos-context-keeper/
- Size: 826 KB
- Stars: 8
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
- Roadmap: docs/roadmap.md
Awesome Lists containing this project
README
# Kairos: The Context Keeper
## About
Kairos: The Context Keeper is an autonomous development supervisor powered by context engineering. It provides a premium project structure for hackathons and developer onboarding, helping teams maintain context and deliver better software faster. By leveraging advanced AI and memory management techniques, it ensures consistent development practices and preserves critical project knowledge across time.
## 📖 Manifesto: Curing AI's Contextual Amnesia
Modern AI coding assistants are powerful, yet flawed. They suffer from Contextual Amnesia, forgetting the core mission, architectural rules, and historical decisions of a project. This leads to inconsistent, out-of-sync, and often incorrect code.
Kairos was born to solve this fundamental problem. Our philosophy is simple: We trust the LLM's intelligence, but we manage its memory and loyalty. Kairos acts as the project's digital twin—a living, evolving supervisor that ensures the AI never forgets.
## 🧠 Key Features
* **Context Engineering**: Advanced context preservation system that learns and adapts to your development patterns
* **Agent-Based Architecture**: Intelligent agents that handle different aspects of development autonomously
* **DevOps Integration**: Seamless integration with modern DevOps tools and cloud platforms
* **Memory Management**: Sophisticated knowledge graph that maintains project context across time
* **Adaptive Learning**: Self-improving system that gets better with each interaction
## 🤔 Why Kairos?
While tools like Cursor and Copilot are excellent assistants, Kairos operates at a higher level—as a supervisor.
* **Proactive vs. Reactive**: Kairos doesn't just respond to prompts; it proactively manages the project's context, correcting deviations before they become problems.
* **Long-Term Memory**: It builds a comprehensive Knowledge Graph of your project, ensuring that decisions made weeks ago still inform today's code.
* **Autonomous Learning**: Kairos is a self-improving system. It learns from its mistakes and fine-tunes its own local models to become a better partner over time.
* **Model Agnostic**: Work with the best tool for the job. Kairos intelligently routes tasks to local models (Ollama), free cloud tiers (Gemini), or powerful proprietary models, optimizing for cost and performance.
## 🏗️ Architecture
```mermaid
graph TD
A[Developer] --> B[Kairos Daemon]
B --> C[Context Engine]
B --> D[Agent System]
C --> E[Memory Store]
D --> F[Task Execution]
E --> G[Neo4j + ChromaDB]
F --> H[LLM Router]
```
## 🛠️ Tech Stack
* **Backend**: Python, FastAPI
* **Storage**: Neo4j (Knowledge Graph), ChromaDB (Vector Store)
* **AI/ML**: Ollama, OpenRouter, Custom Model Routing
* **DevOps**: Docker, Kubernetes, Prometheus
* **Monitoring**: Grafana, Custom Metrics
## 🚀 Getting Started
**⚠️ Important:** Before starting Kairos, please ensure that **Docker Desktop is running** on your system. Kairos relies on Docker to manage its database services (Neo4j, Qdrant) for full functionality.
### ⚡ Quick Start (Local Python)
```bash
# Clone the repository
git clone https://github.com/turtir-ai/kairos-context-keeper.git
cd kairos-context-keeper
# Create virtual environment
python -m venv venv
venv\Scripts\activate # Windows
# source venv/bin/activate # Linux/Mac
# Install dependencies
pip install -r requirements.txt
# Install the package in editable mode to make the 'kairos' command available globally
pip install -e .
**IMPORTANT FOR WINDOWS USERS:** After installation, you might need to add Python's user script directory to your system's PATH to run the `kairos` command globally. This is typically located at `C:\Users\YourUsername\AppData\Roaming\Python\Python312\Scripts`. You can add this to your PATH environment variable in Windows System Properties.
# Setup environment
copy .env.example .env # Windows
# cp .env.example .env # Linux/Mac
# Start Kairos
kairos start # Now works globally from any directory!
# Alternative: python src/main.py
```
### 🌐 Access Points
Once Kairos is running:
- **🏠 Dashboard**: http://localhost:8000/dashboard
- **📚 API Docs**: http://localhost:8000/docs
- **❤️ Health Check**: http://localhost:8000/health
### 🐳 Full Stack with Docker (Optional)
```bash
# Run all services (Kairos + Neo4j + Qdrant + Monitoring)
docker-compose up -d
# Check service status
docker-compose ps
```
For detailed setup instructions, see [SETUP.md](SETUP.md).
## 📈 Roadmap
* Core context engine implementation
* Advanced agent system with specialized roles
* Memory store optimization and scaling
* Task planning and execution improvements
* Multi-repository support
* Team collaboration features
* Custom model fine-tuning pipeline
## 🤝 Contributing
We welcome contributions! Please read our [Contributing Guide](docs/CONTRIBUTING.md) to get started.
## 🏆 Recognition
Check out our project on [DevPost](https://devpost.com/software/kairos-the-context-keeper)!
## 📜 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🔗 Links
* [Project Website](https://turtir-ai.github.io/kairos-context-keeper)
* [GitHub Repository](https://github.com/turtir-ai/kairos-context-keeper)
* [DevPost Project](https://devpost.com/software/kairos-the-context-keeper)
* [Documentation](docs/)
## 📧 Contact
For questions and support, please email us at turtirhey@gmail.com