Overview

Inception ICORE Server is designed as a highly flexible microservice that facilitates:

Short-Term Memory for transient key-value storage (in-memory).
Long-Term Memory for persistent key-value storage (SQLite).
Latent Memory (vector embeddings + similarity search) backed by ChromaDB.
A BaseAgent capable of “remember/recall/if context” operations, with an optional Sentience DSL layer that can be loaded at runtime.
A Chat endpoint that routes incoming messages first to the Sentience DSL (if loaded), then falls back to a standard BaseAgent, and finally to a fallback LLM.
A simple, well-documented HTTP API (built on Axum) for interacting with all layers of memory and agent functionality.

This README will guide you through architecture details, setup instructions, environment configuration, API usage, and development workflows.

See VISION.md for the philosophical motivation and long-term intent behind this project.

Features

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 va