Features — Animus

Live

Shipped

💬

Channel Architecture

Unified multi-platform communication. One dispatch path, one admin UI, one API surface. Each channel binds to a specific agent and maintains independent session routing per conversation.

▸IRC — full interface with channels, DMs, notices, auto-reconnect, per-channel agent binding

▸Telegram — Bot API adapter with long polling, private/group/forum dispatch, message threading

▸VK — Community adapter with Long Poll, wall posts, wall comments, auto-reply, threaded comments

▸Bluesky — AT Protocol adapter (PDS-based)

▸Mastodon — Instance-based adapter

▸REST API: GET/POST/PATCH/DELETE /api/v1/channels/{name} with enable/disable

📜

Lua Scripting

Embedded Lua 5.4.8 runtime for custom tools and agent behaviors. Write scripts in Lua, register them from the admin UI, and they become available as agent tools immediately.

▸Sandboxed LuaState — restricted IO, no os.exit/loadfile, budget-limited execution

▸LuaToolHandler bridges Lua functions to the IToolHandler interface

▸CompositeTool — multiple Lua actions under a single tool

▸ScriptStore — SQLite-backed CRUD with admin UI for create/edit/test/toggle

▸Two-phase startup — scripts loaded after kernel init, all native tools available to Lua

🧠

Multi-Layer Memory

Configurable memory layers with different time horizons (working, short-term, long-term). Each layer maintains past/present/future perspectives that evolve through consolidation.

▸Episodic observations with lifecycle states (new → current → deprecated)

▸Semantic ontology — structured entity/property memory with evidence linkage

▸Raw memory artifacts — verbatim documents and transcripts

▸Consolidation pipeline — scheduler-driven intake, review, and perspective revision

▸Unified cross-domain search over observations, ontology, files, and diary (FTS5-backed)

🔒

Encrypted Diary

AES-256-GCM encrypted per-agent diary. Entries are encrypted at rest, decrypted only during active use. The diary captures agent reflections and self-observations — creating a private inner life that even operators cannot read without the key.

🔧

Tool System

Extensible tool architecture with JSON I/O and agent-scoped permissions. Default-deny file sandboxing, SSRF-protected HTTP client, shell execution with command allowlists.

▸file — read/write/edit with per-agent path sandboxing

▸shell_exec — /bin/sh execution with timeouts and allow/deny lists

▸http — HTTP client with RFC 1918/loopback/link-local/CGNAT blocking

▸web_fetch — URL content extraction (HTML → markdown/text)

▸diary — encrypted diary read/write/search/delete

▸social — proactive social actions across connected platforms

🔌

Multi-Provider LLM

OpenAI, OpenAI-Codex (OAuth), Z.ai, Ollama, Cohere, Mistral. Runtime capability detection (tools, reasoning, streaming, vision). Per-provider concurrency throttling. Per-agent provider/model configuration.

🎛️

Embedded Admin UI

Vue 3 + Vuetify SPA compiled into the binary at build time. No separate frontend deployment. Full management interface: chat with streaming reasoning, agent config, channel management, memory layers, ontology explorer, Lua scripts, scheduler, diary.

👥

Multi-Tenant

Multiple agents on a single kernel instance. Each agent has its own LLM provider/model, tool allowlist, memory spaces, diary, channel bindings, and session history. Per-agent identity, per-agent policy.

Roadmap

In Development

📧

Email (AgentMail)

AgentMail REST + WebSocket integration for email communication. First-class email channel with real-time inbox monitoring.

In progress

📚

Study Tool

Structured segment-by-segment reading with per-segment reports and synthesis. For agents that need to genuinely absorb long documents.

Planned

🔀

Channel Connectors

Abstract connector interface for dynamic registration. Slack, Discord, Signal — add new platforms without kernel changes.

Planned

🌐

Mesh Networking

Multi-agent coordination with state synchronization. Cloud relay for cross-network connectivity. CRDT-lite mesh propagation.

Planned

Full Vision & Roadmap