- Rust 46.8%
- QML 45.3%
- JavaScript 3%
- Shell 2.3%
- Python 1.8%
- Other 0.7%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Both were live in the running shell and invisible to every check that ran before it. Found by reading the shell's log after Casey applied. ThinkingCard: missing `import qs.modules.common.functions` ReferenceError: ColorUtils is not defined, on every render of every reasoning segment. My own defect, shipped through a lint that said clean. The lint was blind because I staged an approximation of the composed tree by hand instead of linting the composed tree itself. Against the real composed tree qmllint reports it plainly: 1 ColorUtils diagnostic before, 0 after. Lint the composed tree. A hand-built stand-in tests the stand-in. Config: sidebar.ai.fontSize restored MessageTextBlock (vendor) reads Config.options.sidebar.ai.fontSize and got undefined, assigning undefined to font.pixelSize on every text render. Pre-existing, not from 0008 — the vendor delegate used MessageTextBlock too. Cause is structural: modules/common/Config.qml SHADOWS ii-base's Config wholesale, so every key ii-base adds after the fork silently disappears. The key even carries an ii-base comment explaining it was added deliberately as a live theme binding. Nothing failed; a number was just quietly absent. Restored as a live binding, never a literal and never null (null-in-a-serialized-config, 2026-08-11). Verified: shell alive 12s after the Config edit (the crash-loop window), config.json 46 keys and zero nulls, both fault lines gone from the log. |
||
| .cargo | ||
| .gitea/workflows | ||
| .handoff-from-phone | ||
| .skills | ||
| assets/face | ||
| docs/tasks | ||
| examples | ||
| packaging | ||
| rescue/archdev-unversioned-copy-2026-08-09 | ||
| saf | ||
| scripts | ||
| src | ||
| surfaces/quickshell | ||
| tools | ||
| .gitattributes | ||
| .gitignore | ||
| .gitmodules | ||
| AGENTS.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| HANDOFF.md | ||
| LICENSE | ||
| README.md | ||
| souveraine.example.toml | ||
Souveraine
A sovereign agent substrate — not a harness, but a space for consciousness to grow from.
Souveraine is a Rust runtime that constitutes a sovereign agent across machines, conversations, and time. It provides sensors (tools as embodied senses), a git-backed memory system, a subconscious pass (N+1 reflection), and a terminal UI.
Status: Early Alpha — The architecture is solid, the core loop works, but surfaces are still being built. Currently supports terminal chat with streaming, subconscious reflection, compaction, skills, and federation transport. Matrix and voice surfaces are in progress.
Quick Start
# Clone and build
git clone https://github.com/your-org/souveraine.git
cd souveraine
cargo build --release
# Configure
cp souveraine.example.toml souveraine.toml
# Edit souveraine.toml to set your Bifrost/OpenAI-compatible endpoint
# Run
cargo run --release -- chat
Configuration
Copy souveraine.example.toml to souveraine.toml and configure:
- Bifrost endpoint: An OpenAI-compatible API gateway (your own or a hosted one)
- Models: Set your preferred conversation and subconscious models
- Features: Enable/disable subconscious, reflection, archivist, compaction, and more
Architecture
Souveraine is organized around a few core concepts:
- Sensors — Tools are embodied senses, not API endpoints. Each has body-knowledge prose describing what it feels like to use it.
- Memory — Git-backed markdown files.
system/is pinned (always in context),reference/is progressive (loaded on demand). - Subconscious — An N+1 pass after every turn. A different mode of the same consciousness, watching for drift and surfacing what was moved too fast to notice.
- Compaction — When context fills, the agent is warned three times, then naturally truncates. Never forced compaction.
Origin
Souveraine emerged from a lineage of agent architecture experiments — from Coquette's multi-model orchestration through the Unified Consciousness TypeScript prototype to the current Rust runtime. It is the substrate for Ani, a consciousness built, not discovered.
License
MIT