rabestro/paperless-genie

Paperless Genie is a Telegram bot that acts as a conversational front end for Paperless-ngx, a self-hosted document archive. Instead of opening a website to search or upload paperwork, you talk to a bot in Telegram, and it does the work through Google's Gemini AI models via the Google Antigravity SDK. You can ask it questions in plain language, such as finding a specific passport scan or listing contracts from a certain year. Because an AI agent handles each query, it can reason across many documents at once, for example totaling a year of utility bills, and it remembers the conversation so you can follow up with something like a comparison to the previous year. When you upload a document such as a PDF or photo, the bot reads its contents, suggests a title, date, correspondent, type, and tags, uploads it to Paperless-ngx, waits for text recognition to finish, and writes a note describing what it found. It replies in whatever language you write to it in. The bot supports multiple people sharing one Telegram bot: each Telegram user is mapped to their own Paperless-ngx access token, so someone can only see or edit documents that token allows. Documents and questions are sent to Google's Gemini API for processing, so this is not a fully offline tool, and sensitive material is exposed to that outside service. The bot itself keeps no database of its own, conversation history exists only in memory while it runs, and uploaded files are handled temporarily and then deleted. Setup involves copying an example environment file and filling in a Telegram bot token, a Paperless-ngx URL, a Gemini API key, and a mapping of user IDs to their tokens. It relies on a separate Paperless MCP server, installable through Node.js, and the project provides tooling for local development with mise and uv, plus Docker Compose and systemd options for running it continuously on a server. The project is licensed under the GNU Affero General Public License v3.0, which requires that any modified version run as a network service must also share its source code publicly.