Skip to content

SuperInstance/exocortex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

19 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

exocortex

PyPI CI License: 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
from si_exocortex import Exocortex

cx = 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).

Component Status Notes
Tiered in-memory store (hot/warm/cold, half-life decay) โœ… Implemented In-process OrderedDicts; no persistence on restart
SurrealDB backend ๐ŸŸก Optional SurrealDBMemoryLayer exists; falls back to in-memory when the surrealdb package/DB is unavailable. Not exercised against a live DB in CI
Embedding ๐ŸŸก Placeholder Operation.EMBED returns random unit vectors โ€” recall is by random-vector similarity, not semantic search
MicroNN train/predict โœ… Implemented Pure-Python single-hidden-layer net; training is simulated (random accuracy)
Dream cycle (k-means consolidation) โœ… Implemented Pure-Python k-means, no sklearn
Resonance engine โœ… Implemented Cross-agent cosine-similarity overlap detection
Cortical bus (pub/sub) โœ… Implemented Asyncio PriorityQueue + fan-out
FastAPI REST + TAP protocol โœ… Implemented TAP = plain-text endpoints sized for ESP32
Textual TUI ("Plato's Cave") โœ… Implemented Requires a real terminal
A2A / MCP protocol servers ๐ŸŸก Stub Enum 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

Repo Language Description
flux-runtime Python Full FLUX runtime: markdownโ†’bytecode, 2037 tests, zero deps
flux-core Rust Register-based bytecode VM, deterministic agent computation
flux-js JavaScript FLUX VM for Node.js and browsers, ~400ns/iter
flux-compiler Rust/Python Formal-methods compiler for safety-critical codegen
flux-vm Rust Stack-based constraint-checking VM, 50 opcodes, Turing-incomplete

PLATO Engine Family

Repo Language Description
plato-server Python Knowledge tiles, fleet sync via Matrix, HTTP API
plato-engine-block Rust Original room runtime: no_std + alloc, builder pattern
plato-engine-block-c C99 Embedded reference: zero heap alloc, bare-metal portable
plato-engine-block-elixir Elixir BEAM supervision trees, fault tolerance, hot reload
plato-runtime-kernel Rust Spatial model: tensor grid, batons, assertion traps

Constraint / Theory Family

Repo Language Description
categorical-agents Rust Category theory for agent composition (functors, naturality)
cuda-constraint-engine CUDA/C GPU constraint checking at 1B+ constraints/sec
grand-pattern-rs Rust Fibonacci dual-direction cellular graph architecture
lau-hodge-theory Rust Hodge decomposition, Betti numbers, spectral sequences
ternary-science Rust Experimental evidence for ternary intelligence, 5 conservation laws

Agent / Infrastructure Family

Repo Language Description
construct-core Rust Layered trait system: bare-metal โ†’ alloc โ†’ async agent runtime
crab Bash Agent shell for repo entry/leave (MUD-room metaphor)
exocortex Rust Persistent cognitive substrate, S3-compatible memory
git-agent Python The repo IS the agent โ€” autonomous lifecycle via Git
capitaine-1 TypeScript Git-native repo-agent, Cloudflare Workers heartbeat
codespace-edge-rd Research Codespaceโ†’Edge agent lifecycle and yoke transfer protocols
git-agent-codespace DevContainer One-click Codespace template for Git-Agent runtimes

Registries

Registry Package Install
PyPI flux-vm pip install flux-vm
PyPI plato-core pip install plato-core
PyPI si-exocortex pip install si-exocortex
crates.io fluxvm cargo add fluxvm
crates.io ternary-science cargo add ternary-science
crates.io categorical-agents cargo add categorical-agents
npm flux-js npm install flux-js (coming soon)

Philosophy & Architecture

  • ๐Ÿ“– AI-Writings โ€” Philosophy, essays, and design rationale
  • ๐Ÿ“ฆ PACKAGES.md โ€” Full package index

About

๐Ÿง  Persistent cognitive substrate for multi-agent systems โ€” S3-compatible memory, shadow rendering, tiered compute, ESP32 support

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors