Airbeeps - Local-first, self-hosted AI assistant for chat and RAG
Project description
Airbeeps
Airbeeps is a self-hosted, local-first assistant-based RAG system for individuals and small teams who want to build AI assistants on top of their own documents.
It is designed to be easy to install, simple to run, and fully under your control.
Features
- 🤖 Pluggable LLM Providers via LiteLLM (OpenAI-compatible APIs, Gemini, and more)
- 📚 RAG Knowledge Base with document upload and semantic search
- 💬 Real-Time Chat with streaming responses
- 🔐 Lightweight Authentication for trusted environments
- 🎨 Web UI Included
- 📦 Single-command install & run
Quick Start
Installation
pip install airbeeps
Run
airbeeps run
On first run, Airbeeps initializes its local data and starts the web interface.
Open the UI at: http://localhost:8500
The first registered user becomes an admin.
Data & Configuration
Airbeeps stores all data locally:
- Linux / macOS:
~/.local/share/airbeeps - Windows:
%APPDATA%\airbeeps
To change the data location:
AIRBEEPS_DATA_ROOT=/path/to/data
Help & Commands
To see all available commands:
airbeeps --help
airbeeps run --help
Documentation
Full documentation and development guides are available on GitHub:
https://github.com/airbeeps/airbeeps
License
MIT License
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file airbeeps-0.1.3.tar.gz.
File metadata
- Download URL: airbeeps-0.1.3.tar.gz
- Upload date:
- Size: 2.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b0eb2f1d470fa0b6ad4faf7e748375804b8bac3b14c402c81f0bd085004acc8
|
|
| MD5 |
9667820860a5789d6e3c7f2e38f956e4
|
|
| BLAKE2b-256 |
ba236a7f75f5d8cc47c4baba7c739ee824a615e400a94c0205938e05b5847cbe
|
File details
Details for the file airbeeps-0.1.3-py3-none-any.whl.
File metadata
- Download URL: airbeeps-0.1.3-py3-none-any.whl
- Upload date:
- Size: 3.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
657015c93946b15c474eb041bda4451bda6367979583974bd31c86fba2154773
|
|
| MD5 |
b0028a3e730aabc54ea339370580bde3
|
|
| BLAKE2b-256 |
3574b3164ccd3df66a9f015108a7fb9f49aa85ed1e47033d5dbb778b86f89c33
|
