nousia-23
Enables deterministic, neural-free compilation of natural language into typed intent and canonical receipts, with proof-gated synthesis and governed tool use via read-only compiler functions.
README
NOUSIA-23

A deterministic synthetic transpiler for natural language, typed intent, proof-gated synthesis, and governed tool use—without a neural runtime.
NOUSIA-23 is the standalone successor to Project 33. It occupies a role that was previously assigned to Qwen3-0.6B in the Polar Pyro TaskIntent pipeline: convert a user's request into stable, machine-checkable meaning for DEMIURGE and specialist engines. Its decisive difference is architectural. It does not sample tokens or load model weights. It parses, constrains, enumerates, collapses, verifies, and emits canonical receipts.
The achievement is not that every English sentence has become formally decidable. It is that a production software-intent lane can replace a neural proposer with an inspectable compiler, produce equal inputs byte-for-byte, fail closed on ambiguity, and expose the same deterministic core to any host through Python, JSON CLI, HTTP, or MCP.
What it guarantees
- Identical admitted input plus identical capability catalog produces identical canonical output.
- Every service response binds the request and result to SHA-256 material.
- Unsupported or underdetermined meaning becomes
NO_RESULTor a clarification residual—not invented intent. - Core installation has no third-party dependency and the production package imports no neural runtime.
- The compiler has no execution authority. Tool effects remain the responsibility of a separately governed host.
- MCP registration does not grant arbitrary capability: manifests must define schema, authority, effects, evidence, scope, timeout, and oracle.
Architecture
English / Task request
│
▼
normalization → parsing → semantic candidates → constraint propagation
│ │
│ ambiguity/residuals ──► questions
▼
canonical Semantic IR / TaskIntentIR
│
├──► Euclid-Ω: proof, planning, counterexample, refinement
├──► DEMIURGE: artifact composition and synthesis
└──► MCP host: governed observation/effect capabilities
│
▼
independent oracle + canonical receipt
NOUSIA-23 determines what an admitted request can mean. Euclid-Ω determines what follows from a formal candidate. MCP supplies governed observations and effects. DEMIURGE composes artifacts. Independent oracles determine whether the output satisfies the contract.
Four stable interfaces
Python
from nousia23 import Nousia23
receipt = Nousia23().execute(
{
"operation": "compile_task_intent",
"request_id": "demo-001",
"payload": {
"project_id": "polar-pyro",
"prompt": "Build an accessible inventory dashboard with audit history",
},
}
)
assert receipt["neural_calls"] == 0
JSON CLI
python -m pip install -e .
echo '{"operation":"capabilities","payload":{}}' | nousia23
Exit codes are 0 for PASS, 3 for NO_RESULT, and 2 for FAIL. Standard output contains exactly one canonical JSON receipt.
HTTP
python -m pip install -e ".[http]"
uvicorn nousia23.http:create_app --factory --host 127.0.0.1 --port 8080
curl http://127.0.0.1:8080/v1/capabilities
The service exposes GET /health, GET /v1/capabilities, and POST /v1/execute. The Docker image runs as an unprivileged user.
MCP
{
"mcpServers": {
"nousia-23": {
"command": "nousia23-mcp",
"args": []
}
}
}
The dependency-free stdio server implements MCP 2025-06-18 initialization, tool discovery, tool calls, and ping. Its four tools are read-only compiler functions: interpret, open-domain grounding, TaskIntent compilation, and independent TaskIntent verification.
Operations
| Operation | Input | Output | Boundary |
|---|---|---|---|
interpret |
controlled English + context | checked packed Semantic IR | unknown constructs fail closed |
compile_open_domain |
unrestricted Unicode + closed catalog | grounded capabilities, spans, residuals, questions | open input is not universal understanding |
compile_task_intent |
software request + project identity | Polar Pyro TaskIntentIR | admitted grammar and ontology |
verify_task_intent |
source request + candidate IR | independent replay receipt | candidate cannot self-certify |
Machine-readable contracts live in schemas/. The normative human specification lives in docs/specification/.
Memory and context
NOUSIA-23 has no transformer context window. It can address a virtually unbounded external corpus through TOAM or another content-addressed store, but computation is deliberately bounded. Every proof/search workspace has explicit budgets, provenance, and eviction rules. The accurate promise is unbounded addressable memory with bounded, auditable working sets, not magical infinite simultaneous context.
Qualification
python -m pip install -e ".[dev,http]"
python -m ruff check .
python -m ruff format --check .
python -m mypy src
python -m pytest --cov=nousia23 --cov-report=term-missing --cov-fail-under=80
python scripts/audit_neural_runtime.py --require-zero
python scripts/qualify_task_intent.py
python scripts/qualify_algorithm_portfolio.py
python -m build
Visual-mind production program
The optional visual profile keeps the compiler zero-neural while admitting pinned,
receipt-producing perception providers outside the core authority boundary. Its
MobileCLIP2-S0 thesis, 300 MB budget, production phases and deterministic phase
controller are documented in
docs/NOUSIA_MOBILECLIP_VISUAL_MIND_THESIS.md
and
docs/NOUSIA_VISUAL_MIND_IMPLEMENTATION_PLAN.md.
python -m nousia23.vision_program verify
python -m nousia23.vision_program status
python -m nousia23.vision_program next
The controller selects and journals work orders. It cannot execute shell strings or
grant provider authority. The program remains PARTIAL until all live, held-out,
resource, cross-platform and independent-review gates pass.
The inherited Project 33 qualification demonstrated exact TaskIntent parity against a frozen Qwen reference lane for the admitted corpus and zero recorded neural calls. Those results are a bounded substitution claim, not proof of unrestricted frontier-model equivalence. NOUSIA-23 treats broader superiority as an empirical program: frozen contracts, held-out corpora, adversarial paraphrases, behavioural artifact oracles, latency/resource measurement, and a mandatory zero-neural-call detector.
The fresh standalone certificate records 119/119 tests, 83.85% branch-aware coverage, strict typing across 29 source files, 37/37 frozen TaskIntent cases, and zero neural-runtime findings. See the qualification record.
Repository map
src/nousia23/ deterministic compiler, IR, reasoners, service transports
schemas/ versioned JSON interface and capability contracts
benchmarks/ frozen, reviewable qualification corpora
scripts/ qualification and neural-runtime audits
tests/ unit, property, regression, transport, and parity tests
docs/specification/ normative multi-document system specification
vision/ visual-mind budget, phase graph, and canonical program state
assets/ defining project artwork
Claims and limits
NOUSIA-23 can be superior to a neural model where determinism, auditability, latency, reproducibility, formal contracts, and fail-closed behaviour are the governing metrics. It does not currently claim universal conversational equivalence, unconstrained world knowledge, or proof of correctness for every English utterance. Internet research is possible only when a host registers scoped search/fetch tools and their evidence oracles; the compiler itself performs no covert network access.
Start with the product constitution, architecture, and interface contracts. The claims ledger separates demonstrated facts from targets.
License
MIT. See LICENSE.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.