Companion Bot

Companion Bot is a personal Telegram bot that helps the author manage a private knowledge base in Obsidian and save visual references to Pinterest. It is a self-hosted, personal-use application running on the author's own machine.

What it does

The bot accepts content from the author through Telegram — text notes, web links, images, screenshots, forwarded posts — and processes it in two ways:

• Knowledge base ingest. The bot analyzes incoming content, suggests an appropriate location within the author's local Obsidian vault (a folder of Markdown files), and writes the content there after the author confirms.
• Search. The author can ask questions in natural language. The bot retrieves relevant fragments from the vault and answers based on the author's own notes.
• Visual references. When the author sends an image, video, or link to a visual resource, the bot saves it to a selected Pinterest board via the official Pinterest API.

How it works

The application runs locally on the author's Windows desktop as a background service. It uses large language model APIs for content analysis and search, and the Pinterest API for saving visual references. All knowledge base data is stored locally as Markdown files in the author's Obsidian vault.

Technology

The bot is built in Python. It uses the Anthropic API for language model tasks, the OpenAI API for text embeddings, and the Pinterest API v5 for saving pins. Data storage is local: a LanceDB vector index, an SQLite database for bot state, and the user's Obsidian vault folder.

Audience

This application is built for and used solely by its author. It is not distributed, published, or made available to other users. There is no signup, no marketing site, no user accounts.

Contact

For questions about this application: [email protected]