Odel
the anots

the anots

@patherasTypeScriptUpdated 5mo ago

Discover and query every business on ANOTS — search, ask, or find-and-ask over MCP.

View on GitHubSign in to connect
Server endpointStreamable HTTPNo authProbed
https://api.anots.com/mcp

This is the third-party server itself — Odel doesn't run it. Hitting this URL directly talks straight to the upstream server with no auth or proxying. Connect through Odel to front it with managed auth.

TCAM Memory System

Resilient 4-Layer Memory Architecture for TCAM v1.4 (Triadic Cognitive Augmentation Model)

Overview

The TCAM Memory System implements a fault-tolerant memory architecture where each layer operates independently, ensuring that system failures in one layer do not cascade to others. Memory operations are handled by a dedicated Memory Service running on Qwen 3.5 9B (local LLM).

Architecture

Four Independent Layers

  • L1: Chronicle - Immutable historical record (file system, markdown)
  • L2: Active Stream - Volatile working memory (Cloud LLM context + Redis)
  • L3: Hive Mind - Semantic memory (Qdrant vector DB + Mem0)
  • L4: Agent Codex - Personal knowledge base (file system, markdown)

Memory Service

Dedicated process running on Qwen 3.5 9B for:

  • Truth extraction from dialogue
  • Chronicle inscription
  • Hive Mind indexing
  • Agent Codex updates
  • Sleeping cycle orchestration

Technology Stack

  • TypeScript/Node.js - Core implementation
  • Qwen 3.5 9B - Local LLM for memory operations
  • Mem0 - Automatic fact extraction
  • Qdrant - Vector database for semantic search
  • Redis - Fast state persistence (LangGraph checkpointer)
  • LangGraph - Multi-agent orchestration
  • Jest - Testing framework
  • fast-check - Property-based testing

Project Structure

.
├── src/                    # Source code
├── tests/                  # Test files
├── data/                   # Chronicle storage
├── codex/                  # Agent Codex (L4)
├── docs/                   # Documentation
└── .kiro/specs/           # Specification documents

Getting Started

Prerequisites

  • Node.js 18+
  • Ollama (for Qwen 3.5 9B)
  • Docker (for Qdrant and Redis)

Installation

# Install dependencies
npm install --legacy-peer-deps

# Pull Qwen 3.5 9B model
ollama pull qwen2.5:9b-instruct-q4_K_M

# Pull embedding model
ollama pull nomic-embed-text

# Start Qdrant (using setup script)
# Windows PowerShell:
.\scripts\setup-qdrant.ps1

# Linux/Mac:
bash scripts/setup-qdrant.sh

# Or manually with Docker:
docker run -d --name qdrant -p 6333:6333 -p 6334:6334 -v qdrant_storage:/qdrant/storage qdrant/qdrant

# Start Redis
docker run -d --name redis -p 6379:6379 redis

# Build and install globally
npm run build
npm install -g . --legacy-peer-deps

CLI Usage

# Interactive main menu
anots

# Real-time monitoring dashboard (Terminal UI)
anots dashboard

# Chat with Axiom (TCAM Node C)
anots axiom

# Start MCP server (19 tools for IDE integration)
anots mcp:start

# Start REST API server
anots api:start

# Start API with Axiom chat endpoint
anots api:start --axiom

# Search memory
anots memory:search "your query"

# Import conversation (JSON/Markdown)
anots import conversation.json --type general

# System status
anots status

# Configuration wizard
anots setup

# Show all commands
anots --help

Dashboard Features

The Terminal UI dashboard (anots dashboard) provides:

  • Real-time memory layer health monitoring
  • System statistics (chapters, sessions, memories)
  • Activity log with timestamps
  • Keyboard shortcuts (F1-F3, R, Q)
  • Auto-refresh every 2 seconds
  • Cyberpunk aesthetic with 90s BBS vibes

Verify Setup

# Check Qdrant
curl http://localhost:6333/health

# Check Redis
redis-cli ping

# Check Ollama
ollama list

Development

# Build
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint
npm run lint

# Format code
npm run format

Importing Conversations

Import large conversation files into the ANOTS memory system:

# Import Ubik conversation
npm run import -- data/import/conversation.json --type ubik

# Import Axiom conversation
npm run import -- data/import/conversation.md --type axiom

# Preview import without writing (dry run)
npm run import -- data/import/conversation.json --dry-run

# Custom chunk size (messages per chapter)
npm run import -- data/import/large-file.json --type ubik --chunk-size 100

What Gets Imported

  1. Chronicle: Conversation history in chapters
  2. Hive Mind: Semantic indexing for search
  3. Codex: Extracted truths and insights

See data/import/README.md for detailed documentation and examples.

Specification

See .kiro/specs/memory-system/ for complete specification:

  • requirements.md - Functional requirements
  • design.md - Technical design
  • tasks.md - Implementation tasks

License

MIT