Docs/Getting Started/Installation

Installation

Basic Install

bash

pip install octopoda

Core package — only dependencies are requests and pydantic.

MCP server for Claude, Cursor, Windsurf:

bash

pip install "octopoda[mcp]"

Local embeddings (semantic search via sentence-transformers):

bash

pip install "octopoda[ai]"

Knowledge graph (spaCy):

bash

pip install "octopoda[nlp]"

LangChain integration:

bash

pip install "octopoda[langchain]"

Self-host the cloud API:

bash

pip install "octopoda[server]"

Everything:

bash

pip install "octopoda[all]"

Start the local daemon — no account, no API key, no cloud:

bash

octopoda

The dashboard opens automatically at:

bash

http://localhost:7842

Local mode requires no API key. All data is stored on your machine in a SQLite database:

Upgrade to cloud later — no code changes

Set OCTOPODA_API_KEY in your environment and the same code switches from local SQLite to the managed cloud backend automatically.