Octopoda OS

communication MCP Server

The open-source memory operating system for AI agents. Persistent memory, semantic search, loop detection, agent messaging, crash recovery, and real-time observability.

Verified
communicationcommunication
11 views343 stars51 forksNOASSERTION

Why This Matters

Discovered via github-seeds and last synced 3mo ago.

Verified
Source
github-seeds
Stars
343
Last synced
3mo ago
Install
Check source

Install

Install instructions not detected yet

Check the source repository for the latest setup steps.

View source instructions
58
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (58)

Local

Cloud

100

10,000

SYNRIX_DATA_DIR

`~/.synrix/data`

Agents

5

Cloud-first

Cloud-first

Variable

Default

Account

Not needed

octopoda_recall_similar

`octopoda_octopoda_recall_similar`

octopoda_agent_stats

`octopoda_octopoda_agent_stats`

octopoda_loop_status

`octopoda_octopoda_loop_status`

octopoda_search_filtered

`octopoda_octopoda_search_filtered`

Yes

Yes

SYNRIX_HEARTBEAT_INTERVAL_SEC

`3`

75

Unlimited

OCTOPODA_LLM_PROVIDER

`none`

Memories

5,000

Built-in

No

Feature

What it does

octopoda_restore

`octopoda_octopoda_restore`

octopoda_forget

`octopoda_octopoda_forget`

octopoda_broadcast

`octopoda_octopoda_broadcast`

octopoda_recall_history

`octopoda_octopoda_recall_history`

octopoda_process_conversation

`octopoda_octopoda_process_conversation`

octopoda_loop_history

`octopoda_octopoda_loop_history`

Free

Pro ($19/mo)

Community

Email (48h)

SYNRIX_MAX_VERSIONS_PER_RUNTIME_KEY

`10`

MIT

Apache 2.0

LangChain

LangChain

octopoda_snapshot

`octopoda_octopoda_snapshot`

octopoda_log_decision

`octopoda_octopoda_log_decision`

octopoda_read_messages

`octopoda_octopoda_read_messages`

Default

Description

Dashboard

http://localhost:7842

octopoda_search

`octopoda_octopoda_search`

octopoda_list_agents

`octopoda_octopoda_list_agents`

octopoda_consolidate

`octopoda_octopoda_consolidate`

octopoda_update_progress

`octopoda_octopoda_update_progress`

1

5

OCTOPODA_LOCAL_MODE

unset

Octopoda

Mem0

octopoda_related

`octopoda_octopoda_related`

octopoda_get_context

`octopoda_octopoda_get_context`

octopoda_send_message

`octopoda_octopoda_send_message`

Storage

SQLite on your machine

octopoda_recall

`octopoda_octopoda_recall`

octopoda_read_shared

`octopoda_octopoda_read_shared`

octopoda_memory_health

`octopoda_octopoda_memory_health`

octopoda_get_goal

`octopoda_octopoda_get_goal`

Basic

Full v2

Setup

`pip install octopoda`

No

No

octopoda_remember

`octopoda_octopoda_remember`

octopoda_share

`octopoda_octopoda_share`

octopoda_forget_stale

`octopoda_octopoda_forget_stale`

octopoda_set_goal

`octopoda_octopoda_set_goal`

OCTOPODA_EMBEDDING_MODEL

`BAAI/bge-small-en-v1.5`

Dedicated

--- ## Installation ```bash pip install octopoda # Core — everything to get started (Python 3.9+) pip install octopoda[ai] # + Local embeddings for semantic search pip install octopoda[server] # + Local dashboard server (Flask) pip install octopoda[nlp] # + spaCy for knowledge graph extraction pip install octopoda[mcp] # + MCP server for Claude/Cursor (Python 3.10+) pip install octopoda[all] # Everything (Python 3.10+) ``` > **Python version note:** the core package supports Python 3.9 and up. The `[mcp]` extra requires Python 3.10+ because the upstream `mcp` library does. If you're on 3.9 and want everything except MCP, use `pip install octopoda[ai,server,nlp]`. > **Local-mode note:** running without an API key (`pip install octopoda` only) gives you a fully working local install with SQLite at `~/.synrix/data/synrix.db`. The `OCTOPODA_API_KEY` environment variable accepts the sentinels `local`, `offline`, `dev`, `none`, or `YOUR_KEY_HERE` to explicitly force local mode. Real cloud keys start with `sk-octopoda-`; anything else is treated as a local sentinel rather than hung on cloud auth. > **Updating Claude Code MCP registration:** if you change the `claude mcp add octopoda ...` env vars (for example, swapping from local to cloud), restart the Claude Code window. `/mcp` reconnect alone won't pick up the new env because the child process inherits Claude Code's cached env at startup. ## Configuration