Modular Memory Layers

Short-Term: Fast, in-memory key-value store (volatile).
Long-Term: Persistent SQLite-backed key-value store.
Latent Memory: Vector embeddings and nearest-neighbor queries via ChromaDB.

Agent Logic

BaseAgent: Simple “remember”, “recall”, and “if context includes” logic.
Sentience DSL: Loadable DSL for scripting custom response logic, with seamless seeding/flushing of memory layers.

LLM Fallback

Out-of-the-box integration with any HTTP-based LLM (e.g., a local Llama server) for fallback generation.

HTTP API

Exposes endpoints for managing memory, embedding/querying vectors, chatting, and running DSL code directly.
JSON-based request/response formats.

Docker Compose Setup

Preconfigured docker-compose.dev.yml to orchestrate ChromaDB, a local LLM service, and the ICORE Server.

Asynchronous

Built on Rust’s Tokio runtime for high concurrency and performance.

Extensible & Configurable

Easily swap out ChromaDB URL, LLM URL, database paths, and DSL scripts via environment variables.

Architecture & Components

Architecture as Brain

The inception-ICORE-server acts as the brain stem of an artificial intelligence system — responsible for coordination, memory routing, and protocol-level reflexes.

Its structure is inspired by the biological brain:

Inception (this server) — Brain stem Manages memory access, agent execution, and DSL processing. It doesn't "think" — it regulates.
Cortex (Memory layers) — Cognitive cortex
Stores long-term knowledge (SQLite), short-term working memory (in-memory), and latent semantic space (ChromaDB).
Agents — Organs
Input/output entities that perceive, act, and reflect using structured memory and embedded logic.
ICORE Protocol — Neural signals
A standardized communication flow between memory, agents, and logic evaluators.

This separation enables modular development, autonomous behavior, and semantic reflection — one layer at a time.

Below is a high-level architecture diagram and description of each core component and how they interact:

Inception ICORE Architecture

BaseAgent & Sentience DSL

BaseAgent (agents/agent.rs):
- Maintains an in-process context (Context) for simple “remember/recall/if context includes” logic.
- Loads and executes Sentience DSL code directly using the sentience crate.
- During handle, DSL memory is seeded from global stores and flushed back after execution.

Memory Layers

Short-Term Memory (memory/short_term.rs):
- In-memory HashMap<String, String>.
- Fast read/write for transient key-value pairs.
- Volatile (lost on server restart).
Long-Term Memory (memory/long_term.rs):
- SQLite-backed key-value store (via sqlx).
- Persistent on disk (memory.db).
- Async get, set, and all operations.
Latent Memory (memory/latent.rs):

Categories

Current Category: agent-framework

mcp-server

inception-core-server