Skip to content

Repository files navigation

exocortex

PyPICILicense: MIT

🧠 Persistent cognitive substrate for multi-agent systems — tiered in-memory store with optional SurrealDB backend, shadow rendering, tiered compute, ESP32-friendly TAP protocol


Quick Start

pip install si-exocortex
fromsi_exocorteximportExocortexcx=Exocortex()
cx.remember("task_1", {"status": "pending", "priority": "high"})
cx.recall("task_1")

About

Part of the SuperInstance fleet ecosystem — a distributed cognitive agent orchestration platform built across ARM64 and x86_64 clusters.

Related Fleet Repos

Component Status

Feature maturity, stated honestly (a claim previously described storage as "S3-compatible" — there is no S3 / object-storage code; storage is an in-memory tiered store with an optional SurrealDB backend).

ComponentStatusNotes
Tiered in-memory store (hot/warm/cold, half-life decay)✅ ImplementedIn-process OrderedDicts; no persistence on restart
SurrealDB backend🟡 OptionalSurrealDBMemoryLayer exists; falls back to in-memory when the surrealdb package/DB is unavailable. Not exercised against a live DB in CI
Embedding🟡 PlaceholderOperation.EMBED returns random unit vectors — recall is by random-vector similarity, not semantic search
MicroNN train/predict✅ ImplementedPure-Python single-hidden-layer net; training is simulated (random accuracy)
Dream cycle (k-means consolidation)✅ ImplementedPure-Python k-means, no sklearn
Resonance engine✅ ImplementedCross-agent cosine-similarity overlap detection
Cortical bus (pub/sub)✅ ImplementedAsyncio PriorityQueue + fan-out
FastAPI REST + TAP protocol✅ ImplementedTAP = plain-text endpoints sized for ESP32
Textual TUI ("Plato's Cave")✅ ImplementedRequires a real terminal
A2A / MCP protocol servers🟡 StubEnum values only; no server implementations

Cross-Implementation

This component exists in two languages:

Both implement the same specification. Choose based on your runtime.

License

MIT


🦀 Part of the SuperInstance Fleet — The crab inherits the shell. The forge shapes the steel.

Ecosystem

This repo is part of the SuperInstance flagship ecosystem — agent-first computation, constraint theory, and self-improving runtimes.

FLUX Runtime Family

RepoLanguageDescription
flux-runtimePythonFull FLUX runtime: markdown→bytecode, 2037 tests, zero deps
flux-coreRustRegister-based bytecode VM, deterministic agent computation
flux-jsJavaScriptFLUX VM for Node.js and browsers, ~400ns/iter
flux-compilerRust/PythonFormal-methods compiler for safety-critical codegen
flux-vmRustStack-based constraint-checking VM, 50 opcodes, Turing-incomplete

PLATO Engine Family

RepoLanguageDescription
plato-serverPythonKnowledge tiles, fleet sync via Matrix, HTTP API
plato-engine-blockRustOriginal room runtime: no_std + alloc, builder pattern
plato-engine-block-cC99Embedded reference: zero heap alloc, bare-metal portable
plato-engine-block-elixirElixirBEAM supervision trees, fault tolerance, hot reload
plato-runtime-kernelRustSpatial model: tensor grid, batons, assertion traps

Constraint / Theory Family

RepoLanguageDescription
categorical-agentsRustCategory theory for agent composition (functors, naturality)
cuda-constraint-engineCUDA/CGPU constraint checking at 1B+ constraints/sec
grand-pattern-rsRustFibonacci dual-direction cellular graph architecture
lau-hodge-theoryRustHodge decomposition, Betti numbers, spectral sequences
ternary-scienceRustExperimental evidence for ternary intelligence, 5 conservation laws

Agent / Infrastructure Family

RepoLanguageDescription
construct-coreRustLayered trait system: bare-metal → alloc → async agent runtime
crabBashAgent shell for repo entry/leave (MUD-room metaphor)
exocortexRustPersistent cognitive substrate, S3-compatible memory
git-agentPythonThe repo IS the agent — autonomous lifecycle via Git
capitaine-1TypeScriptGit-native repo-agent, Cloudflare Workers heartbeat
codespace-edge-rdResearchCodespace→Edge agent lifecycle and yoke transfer protocols
git-agent-codespaceDevContainerOne-click Codespace template for Git-Agent runtimes

Registries

RegistryPackageInstall
PyPIflux-vmpip install flux-vm
PyPIplato-corepip install plato-core
PyPIsi-exocortexpip install si-exocortex
crates.iofluxvmcargo add fluxvm
crates.ioternary-sciencecargo add ternary-science
crates.iocategorical-agentscargo add categorical-agents
npmflux-jsnpm install flux-js(coming soon)

Philosophy & Architecture

About

🧠 Persistent cognitive substrate for multi-agent systems — S3-compatible memory, shadow rendering, tiered compute, ESP32 support

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages