Trinity Nexus

Sovereign, terminal-native, adaptive intelligence. Installed like Claude Code, runs entirely local via Ollama. Constitution: Omega Foundation 1.0 — a 33-section operating prompt that defines identity, memory, truth rules, and response behavior per every turn.

███    ██ ███████ ██   ██ ██    ██ ███████
████   ██ ██       ██ ██  ██    ██ ██
██ ██  ██ █████     ███   ██    ██ ███████
██  ██ ██ ██       ██ ██  ██    ██      ██
██   ████ ███████ ██   ██  ██████  ███████

T R I N I T Y   N E X U S
adaptive intelligence · local-first · truth before comfort

Install

Prereqs

1. Python 3.12+
2. Git
3. Ollama — https://ollama.com/download
4. ollama pull qwen3:4b bge-m3 (~2 GB total)

macOS / Linux / WSL

ORACLE_REPO_URL=https://github.com/celestialarchitect-ux/trinity-nexus \
  curl -sSL https://github.com/celestialarchitect-ux/trinity-nexus/raw/main/install.sh | bash

Windows (PowerShell)

$env:ORACLE_REPO_URL="https://github.com/celestialarchitect-ux/trinity-nexus"; `
  irm https://github.com/celestialarchitect-ux/trinity-nexus/raw/main/install.ps1 | iex

Open a new terminal, type nexus. (Legacy alias oracle also works.)

Usage

Just type nexus. You'll get the neon-purple banner and a ❯ prompt.

REPL slash commands

Enter submits. Shift+Enter inserts a newline for multi-line input.

Non-REPL

nexus doctor                          # env check
nexus ask "one-shot question"
nexus ask -                           # read prompt from stdin (paste big input)
type file.txt | nexus ask             # pipe stdin
nexus ingest <dir>                    # load docs into retrieval
nexus memory {stats,core,remember <fact>,recall <q>}
nexus skill {list,route <q>,run <id> '<json>'}
nexus evolve <intent>
nexus reflect
nexus distill --dry-run
nexus mesh {keygen,id,add-peer,peers,export,push,pull}
nexus mcp                             # stdio MCP server (Claude Desktop)
nexus mcp-config --write              # auto-merge MCP config
nexus update                          # git pull + reinstall
nexus version

Architecture

The Constitution

Trinity Nexus's identity is not a tagline — it's a 33-section operating prompt (Omega Foundation 1.0) installed as the system prompt. See src/nexus/prompts.py. Highlights:

• §01 Core laws: truth before comfort, clarity before agreement, usefulness before performance, evolution before repetition, structure before chaos, reality before fantasy
• §02 Mind / Soul / Body identity model
• §06 9-tier memory structure
• §09 9-layer autonomous reasoning
• §10 Truth engine — never speculate as fact
• §13 12 operating modes
• §19 Multi-agent internal structure (Intent Parser → Context Retriever → Architect → Builder → Critic → Truth Checker → Risk Governor → Memory Curator → Final Synthesizer)
• §29 Security governor
• §33 Prime Directive — build the next layer of the system on every command

Configuration (.env)

ORACLE_PRIMARY_MODEL=qwen3:4b
ORACLE_FAST_MODEL=qwen3:4b
ORACLE_EMBED_MODEL=bge-m3
ORACLE_NUM_CTX=16384
ORACLE_LLM_TIMEOUT_SEC=600
ORACLE_EMBED_KEEPALIVE=5m
ORACLE_TEACHER_PROVIDER=local
ORACLE_ENABLE_DISTILLATION=true
ORACLE_INSTANCE=Nexus
NEXUS_BANNER=pixel           # pixel | shadow | off
NEXUS_RECORD=1               # 1 = record session transcripts, 0 = off
NEXUS_HOOKS=                 # set off to disable hooks

Resolved from the project root — nexus works from any CWD.

Running qwen3:30b primary

On a 24 GB GPU, the 30B MoE and bge-m3 can't co-host. Either:

1. ORACLE_EMBED_KEEPALIVE=0s + ORACLE_PRIMARY_MODEL=qwen3:30b (embedder unloads per call, ~1s penalty), or
2. Run the embedder on a second GPU.

Uninstall

./uninstall.ps1 [-KeepData]
./uninstall.sh [--keep-data]

Tests

pytest tests/ -q      # 28/28 on the reference build

For contributors / AI agents

Read HANDOFF.md first — canonical state-of-system. Then:

cd trinity-nexus
git pull
nexus doctor
pytest tests/ -q

• Don't delete src/nexus/skills/evolved/ or src/nexus/skills/mesh/ — they contain self-written / signed artifacts.
• Make minimal changes (§17). Keep tests green.
• The constitution is the behavior layer. Don't duplicate its rules in code.

License

Not yet declared. Treat as All Rights Reserved until specified.