Notion Knowledge Assistant

Notion Knowledge Assistant is a self-hosted Telegram bot for people who keep research, reference notes or study material in Notion. You run the Python app on your own hardware or server, including through Docker, but answers depend on OpenAI's paid cloud API. It also needs connections to Notion and Telegram, so self-hosting doesn't make it an offline assistant.

The bot searches a connected Notion database containing text pages, PDFs and DOCX files, then sends matched content to OpenAI to generate a structured answer. Responses link back to the original Notion pages so you can check the supporting material. The default model is gpt-4o-mini.

Its search uses RapidFuzz to find similar wording rather than semantic embeddings. When a query produces weak matches, the assistant can reformulate it. A separate search mode returns matches without AI processing, which is useful when you want to find a passage rather than ask for an explanation.

The interface is Russian, and the bot handles questions in Russian and English. Its focus on a curated collection suits researchers, therapists and coaches, as well as students querying textbooks or writers searching reference notes. The application is open source under the MIT license.

Each deployment connects to one Notion database; separate workspaces require separate instances. There are no individual user access controls: everyone with the bot link can access the same connected data.