altk-evolve

Overview

Evolve is a system that helps AI agents improve over time by learning from their interactions and experiences. It uses an MCP server for tool integration, vector storage for memory management, and LLM-based conflict resolution to refine its knowledge base. The system maintains a feedback loop, taking conversation traces from agents, extracting key insights into a database, and feeding that information back to improve future performance. It supports both lite mode for existing agent assistants and a full MCP server implementation with comprehensive entity management capabilities.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_entitiesget_entities(task: str, entity_type: str = "guideline", include_public: bool = False)

  Get relevant entities for a specific task

  Try:Get guidelines for writing safer codeTry:Retrieve all public guidelines for my current task
• get_guidelinesget_guidelines(task: str)

  Get relevant guidelines for a specific task

  Try:Find guidelines for debugging Python codeTry:Get best practices for API design
• save_trajectorysave_trajectory(trajectory_data: str, task_id: str | None, owner_id: str | None)

  Save a conversation trajectory and generate new guidelines

  Try:Save this conversation about database optimizationTry:Record my troubleshooting session for future reference
• create_entitycreate_entity(content: str, entity_type: str, metadata: str | None, enable_conflict_resolution: bool, owner_id: str | None, visibility: str = "private")

  Create a new entity with optional conflict resolution

  Try:Create a new guideline for error handlingTry:Add a best practice entity with public visibility
• publish_entitypublish_entity(entity_id: str, user_id: str | None)

  Make an entity publicly visible to all namespaces

  Try:Publish guideline ID 42 to share with other usersTry:Make my troubleshooting guide public
• unpublish_entityunpublish_entity(entity_id: str, user_id: str | None = None)

  Revert an entity to private visibility

  Try:Make my guideline private againTry:Unpublish entity ID 42 from public access
• delete_entitydelete_entity(entity_id: str)

  Delete a specific entity by its ID

  Try:Remove outdated guideline ID 123Try:Delete the old debugging entity

Comparable tools

Installation

git clone https://github.com/agenttoolkit/altk-evolve.git
cd altk-evolve
uv venv --python=3.12 && source .venv/bin/activate
uv sync
# Build the UI
cd frontend/ui
npm ci && npm run build
cd ../..

pip install altk-evolve

export OPENAI_API_KEY=sk-...

uv run evolve-mcp

{
  "mcpServers": {
    "evolve": {
      "command": "uv",
      "args": ["run", "evolve-mcp"]
    }
  }
}

FAQ

What is the difference between Lite mode and full MCP server mode?

Lite mode is designed to integrate with existing agent assistants like Claude Code and Codex without the full Interaction layer. Full MCP server mode includes all features including comprehensive entity management, conflict resolution, and sharing capabilities through the MCP protocol.

How does Evolve handle conflicting guidelines?

Evolve uses LLM-based conflict resolution to refine its knowledge base. When new information contradicts existing guidelines, it automatically updates them based on the new insights, improving the knowledge base over time.

Compare altk-evolve with