Cleo

Cleo is an issue-centered fact-layer and audit system for controversial online discussions.

This repository starts with the core persistence module:

• global source assets: Source, Snapshot, Observation
• issue-local interpretation: canonical Event / Entity graph nodes and typed edges
• embedded source/evidence payloads on events and edges, with Assessment deriving certainty
• append-only graph history: GraphCommit
• case read-only audit: GraphReadSet, Draft, DraftSpan

Automation for discovery and publishing is intentionally out of scope for the first implementation pass.

Local Dev

Start the server in your own terminal so backend errors and provider failures stay visible:

.\scripts\dev.ps1

Then open:

http://127.0.0.1:8001/admin

Required .env values for automatic research:

CLEO_TAVILY_API_KEY=...
CLEO_LLM_BASE_URL=https://your-openai-compatible-host/v1
CLEO_LLM_API_KEY=...
CLEO_LLM_MODEL=...
CLEO_LLM_TIMEOUT_SECONDS=300
CLEO_EMBEDDING_BASE_URL=http://127.0.0.1:9997/v1
CLEO_EMBEDDING_MODEL=BAAI/bge-m3
CLEO_EMBEDDING_TIMEOUT_SECONDS=120
# Optional for local BGE providers; set it only if your embedding endpoint requires auth.
CLEO_EMBEDDING_API_KEY=...

The main admin path is Create Issue + Auto Graph. It creates the Issue, runs the research loop, stores sources/snapshots/observations, writes the IssueGraph, then loads the graph view. Create Only and Rebuild Graph From Materials are lower-level debugging actions.