cognitions-agent

Python service for cognition-grounded Q&A, on-demand vectorization, and contradiction detection.

Run

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
uvicorn app.main:app --reload

Environment

Set these vars:

• CORS_ALLOW_ORIGINS (default http://localhost:5173, comma-separated for multiple)
• SUPABASE_URL
• SUPABASE_SERVICE_ROLE_KEY
• SUPABASE_JWT_SECRET (optional; local HS256 decode shortcut)
• OPENAI_API_KEY
• OPENAI_EMBEDDING_MODEL (default text-embedding-3-small)
• OPENAI_CHAT_MODEL (default gpt-4o-mini)

Required Supabase schemas

Create these in your Supabase backend:

• supabase/schemas/001_cognition_embedding_state.sql
• supabase/schemas/002_cognition_contradictions.sql