1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@th0th search for login function in my project"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.

curl -fsSL https://raw.githubusercontent.com/S1LV4/th0th/main/install.sh | bash

# Docker mode, custom port, skip start
TH0TH_MODE=docker TH0TH_API_PORT=4000 TH0TH_NO_START=1 \
 curl -fsSL https://raw.githubusercontent.com/S1LV4/th0th/main/install.sh | bash

# 1. Clone and install
git clone https://github.com/S1LV4/th0th.git
cd th0th
bun install

# 2. Setup (100% offline with Ollama)
./scripts/setup-local-first.sh
# - Installs/starts Ollama
# - Pulls bge-m3 embedding model (1024 dimensions)
# - Creates .env with defaults
# - Runs bun run diagnose to validate the stack

# 3. Build and start
bun run build
bun run start:api

{
 "mcp": {
 "th0th": {
 "type": "local",
 "command": [
 "bunx",
 "@th0th-ai/mcp-client"
 ],
 "environment": {
 "TH0TH_API_URL": "http://localhost:3333"
 },
 "enabled": true
 }
 }
}

{
 "plugin": ["@th0th-ai/opencode-plugin"]
}

{
 "mcpServers": {
 "th0th": {
 "type": "local",
 "command": ["bun", "run", "/path/to/th0th/apps/mcp-client/src/index.ts"],
 "enabled": true
 }
 }
}

{
 "servers": {
 "th0th": {
 "command": "bunx",
 "args": ["@th0th-ai/mcp-client"],
 "env": {
 "TH0TH_API_URL": "http://localhost:3333"
 }
 }
 }
}

{
 "mcpServers": {
 "th0th": {
 "type": "local",
 "command": ["docker", "compose", "run", "--rm", "-i", "mcp"],
 "enabled": true
 }
 }
}

# Development
bun run dev:api

# Production
bun run start:api

# Index a project
curl -X POST http://localhost:3333/api/v1/project/index \
 -H "Content-Type: application/json" \
 -d '{"projectPath": "/home/user/my-project", "projectId": "my-project"}'

# Search
curl -X POST http://localhost:3333/api/v1/search/project \
 -H "Content-Type: application/json" \
 -d '{"query": "authentication", "projectId": "my-project"}'

# Store memory
curl -X POST http://localhost:3333/api/v1/memory/store \
 -H "Content-Type: application/json" \
 -d '{"content": "Important decision...", "type": "decision"}'

# Compress context
curl -X POST http://localhost:3333/api/v1/context/compress \
 -H "Content-Type: application/json" \
 -d '{"content": "...", "strategy": "code_structure"}'

# Show current configuration
npx @th0th-ai/mcp-client --config-show

# Show config file path
npx @th0th-ai/mcp-client --config-path

# Show config directory
npx @th0th-ai/mcp-client --config-dir

# Initialize configuration
npx @th0th-ai/mcp-client --config-init

# Show help
npx @th0th-ai/mcp-client --help

# Initialize with specific provider
npx @th0th-ai/mcp-client --config-init # Ollama (default)
npx @th0th-ai/mcp-client --config-init --mistral your-api-key # Mistral
npx @th0th-ai/mcp-client --config-init --openai your-api-key # OpenAI

# Switch provider
npx @th0th-ai/mcp-client --config-init --mistral your-api-key
npx @th0th-ai/mcp-client --config-init --ollama-model qwen3-embedding

# Set specific configuration values
npx @th0th-ai/mcp-client --config-set embedding.dimensions 4096

th0th/
├── apps/
│ ├── mcp-client/ # MCP Server (stdio)
│ ├── tools-api/ # REST API (port 3333)
│ └── opencode-plugin/ # OpenCode plugin
├── packages/
│ ├── core/ # Business logic, search, embeddings, compression
│ └── shared/ # Shared types & utilities
└── scripts/

Looking for Admin?