open-brain-companion

Guide Open Brain setup, troubleshooting, and extension with technical reference.

2|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/izomba-lang/open-brain-overview --skill open-brain-companion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: open-brain-companion
Source: https://github.com/izomba-lang/open-brain-overview/tree/main/skills/open-brain-companion
Command: npx skills add https://github.com/izomba-lang/open-brain-overview --skill open-brain-companion

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Open Brain is a powerful personal AI memory system that aggregates thoughts from Telegram, Slack, calls, emails and other sources into a searchable wiki, but setting it up, troubleshooting integration issues, or extending its functionality can be overwhelming for both new and experienced users. This Skill eliminates that friction by providing tailored guidance for every stage of your Open Brain journey.

Core Features & Use Cases

  • Guided Setup for New Users: Step-by-step walkthrough for creating a Supabase project, configuring the database, deploying Edge Functions, setting up the Telegram bot, and connecting AI clients, with checkpoints to avoid errors.
  • Targeted Troubleshooting: Protocol for diagnosing common issues like MCP auth errors, Telegram bot failures, weak semantic search, and Slack integration bugs, with specific fixes for each scenario.
  • Technical Reference for Extension: Full documentation of the system architecture, MCP tools, database schema, and guides for adding custom tools, capture sources, or migrating data from other tools.
  • Use Case: A user who gets a 401 error when connecting their MCP server can get immediate help fixing their access key configuration, while a new user with no SQL experience can set up the entire system without getting lost in technical documentation.

Quick Start

Ask the Open Brain Companion to guide you through setting up your Open Brain personal AI memory system from scratch, step by step.

Frequently Asked Questions about open-brain-companion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a personal AI memory system with Supabase and Telegram from scratch?

To set up a personal AI memory system, you need to create a Supabase project, configure the database, deploy Edge Functions, and connect your Telegram bot. Guided walkthroughs provide step-by-step configuration with checkpoints to prevent errors.

Why does my MCP server return a 401 auth error when connecting to my AI memory?

An MCP server 401 auth error usually means your access key configuration is incorrect. You can resolve this by checking your authentication credentials and applying specific fixes for your MCP client integration to restore connectivity.

How do I fix weak semantic search results in my Supabase vector database?

Weak semantic search in your Supabase vector database can be fixed by diagnosing your vector embeddings and query configurations. Targeted troubleshooting protocols help identify search index issues and apply specific fixes to improve retrieval accuracy.

Can I extend my personal AI memory system with custom capture sources and tools?

You can extend your personal AI memory system by using technical reference documentation for the database schema and MCP tools. These guides help you add custom capture sources, build new tools, and migrate data from other platforms.

Do I need SQL experience to configure an Open Brain Supabase database?

You do not need SQL experience to configure an Open Brain Supabase database. The guided setup process walks beginners through the entire database configuration without getting lost in complex technical documentation.