nestorcolt/cognition repository overview

⁠Cognition AI

A sophisticated agent framework built on CrewAI that provides dynamic tooling, configuration management, and scalable memory systems.

⁠Key Features

• Portkey LLM management integration
• Hot-reloadable YAML configuration system
• Multi-tier memory system with ChromaDB and PostgreSQL
• External tool integration
• Core Crew system with Planning and Execution agents
• Cloud-native design for scalability

⁠Environment Variables

⁠Required

• PORTKEY_API_KEY: API key for Portkey LLM routing
• PORTKEY_VIRTUAL_KEY: Virtual key for Portkey

⁠Optional

• COGNITION_CONFIG_SOURCE: Git repository URL to clone configuration (e.g., "[email protected]⁠:user/config-repo.git")
  • If set, will clone the repository to ~/.cognition
• COGNITION_CONFIG_DIR: Path to your configuration directory (e.g., "/home/user/.cognition/cognition-config-demo/config")
• CONFIG_RELOAD_TIMEOUT: Config reload timeout (default: 0.1)
• LONG_TERM_DB_PASSWORD: PostgreSQL database password
• CHROMA_PASSWORD: ChromaDB password
• APP_LOG_LEVEL: Logging level (default: INFO)
• ANTHROPIC_API_KEY: API key for Anthropic services
• HUGGINGFACE_API_TOKEN: Token for Hugging Face services

⁠Quick Start

docker run -p 8000:8000 \
  -e PORTKEY_API_KEY="your-key" \
  -e PORTKEY_VIRTUAL_KEY="your-virtual-key" \
  -e COGNITION_CONFIG_SOURCE="your-git-repo" \
  -e COGNITION_CONFIG_DIR="/home/user/.cognition/cognition-config-demo/config" \
  cognition

Built for AI agent development with emphasis on simplicity, scalability, and maintainability.