1---2name: "utopia"3description: "Operate deeplethe/utopia, the Rust/Postgres bitemporal knowledge application with ontology-driven ingest, review, search/chat, derivation and per-base MCP. Use when users name Utopia/utopia.bi or ask to deploy, configure, inspect, back up or integrate this exact knowledge platform. This is a full application with a database, not a generic ontology library or a local-only graph engine; route standalone RDF/OWL analysis to Open Ontologies or Python pipelines to Semantica."4allowed-tools: Bash Read Grep Glob5compatibility: "Requires Docker Compose for the documented app deployment, PostgreSQL with pgvector, and configured chat/embedding endpoints; local source development also requires Rust and frontend tooling."6metadata:7 version: "1.0.0"8 source: https://skillmd.com/skills/akillness/utopia9 upstream: "https://github.com/deeplethe/utopia"10 upstream_commit: "cda374771577b2d42ed257312864ecf8e067bfbd"11---1213# Utopia1415## Instructions16171. Determine whether the user wants an app deployment, local development, data-backup operation, or read-only architecture guidance. Inspect the pinned release/source and deployed config path before acting.182. The README documents `docker compose --profile app up -d`; it exposes the app on localhost:1516 and initializes a public knowledge base on first account registration. This is an example only. Do not deploy, start services, register accounts, or change database/config state without explicit approval.193. Treat ingestion, extraction, model calls, database mounts, MCP writes, migrations, backup/restore, and public deployment as separate approval gates. Confirm data classification, target base/database, provider, cost, and destination before any external transfer or mutation.204. Preserve the app's review boundary: uncertain facts and agent write proposals require human adjudication. Do not claim an MCP connection can write directly unless source/docs for the exact operation support it.2122## Examples2324- “Explain Utopia's bitemporal model and what its audit ledger retains.”25- “Plan a local Docker deployment, but do not start it.”26- “Configure a read-only MCP client for one knowledge base.”2728## Best practices2930- The first registered account becomes system administrator, and the initial knowledge base is public in the documented quick start; flag this before signup and verify current deployment settings.31- Keep secrets out of chat and reports. Utopia reads `UTOPIA_` environment configuration; `secret.key` protects stored credentials and must not be bundled casually with data backups.32- Read [`references/upstream.md`](references/upstream.md) for backup/restore caveats, exact commands and deployment scope. Example `down -v` is destructive and must never be run without explicit approval.3334## References3536- [`references/upstream.md`](references/upstream.md) - app setup, config, CLI/backups, limits, license and approval gates.37- [`references/source.json`](references/source.json) - selected pinned file SHA256s; not a whole-revision attestation.38- [`evals/evals.json`](evals/evals.json) - authored routing and boundary scenarios, not executed model-quality tests.