Metadata-Version: 2.4
Name: airbeeps
Version: 0.1.5
Summary: Airbeeps - Local-first, self-hosted AI assistant for chat and RAG
Project-URL: Homepage, https://github.com/airbeeps/airbeeps
Project-URL: Repository, https://github.com/airbeeps/airbeeps
Project-URL: Documentation, https://github.com/airbeeps/airbeeps/tree/main/docs
Project-URL: Bug Tracker, https://github.com/airbeeps/airbeeps/issues
Project-URL: Changelog, https://github.com/airbeeps/airbeeps/blob/main/CHANGELOG.md
Author-email: Sreejith <hello@airbeeps.com>
License: MIT License
        
        Copyright (c) 2026 Airbeeps
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: ai,assistant,chat,fastapi,llm,rag
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: <3.14,>=3.13
Requires-Dist: aioboto3>=15.1.0
Requires-Dist: aiomysql>=0.2.0
Requires-Dist: aiosqlite>=0.21.0
Requires-Dist: alembic>=1.16.5
Requires-Dist: asyncpg>=0.30.0
Requires-Dist: authlib>=1.6.4
Requires-Dist: boto3>=1.35.0
Requires-Dist: chromadb>=0.5.4
Requires-Dist: cryptography>=45.0.7
Requires-Dist: dashscope>=1.24.5
Requires-Dist: defusedxml>=0.7.1
Requires-Dist: fastapi-mail>=1.5.0
Requires-Dist: fastapi-pagination>=0.14.1
Requires-Dist: fastapi-users[sqlalchemy]>=14.0.1
Requires-Dist: fastapi[standard]>=0.116.1
Requires-Dist: filetype>=1.2.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: itsdangerous>=2.2.0
Requires-Dist: langchain-chroma>=1.0.0
Requires-Dist: langchain-community>=0.4.1
Requires-Dist: langchain-huggingface>=0.1.0
Requires-Dist: langchain-text-splitters>=1.0.0
Requires-Dist: litellm>=1.80.10
Requires-Dist: magic-filter>=0.0.8
Requires-Dist: markitdown[docx,pdf,pptx,xls,xlsx]>=0.1.3
Requires-Dist: mcp>=1.18.0
Requires-Dist: pillow>=10.4.0
Requires-Dist: platformdirs>=4.0.0
Requires-Dist: pydantic-settings>=2.10.1
Requires-Dist: pymupdf>=1.24.0
Requires-Dist: python-multipart>=0.0.12
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: rich>=13.0.0
Requires-Dist: sentence-transformers>=3.0.1
Requires-Dist: slowapi>=0.1.9
Requires-Dist: sqladmin>=0.21.0
Requires-Dist: sqlalchemy-utils>=0.42.0
Requires-Dist: sqlalchemy[asyncio]>=2.0.43
Requires-Dist: starlette-babel>=1.0.3
Requires-Dist: tiktoken>=0.11.0
Requires-Dist: typer>=0.12.5
Description-Content-Type: text/markdown

# 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

```bash
pip install airbeeps
```

### Run

```bash
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:

```bash
AIRBEEPS_DATA_ROOT=/path/to/data
```

---

## Help & Commands

To see all available commands:

```bash
airbeeps --help
airbeeps run --help
```

---

## Documentation

Full documentation and development guides are available on GitHub:

https://github.com/airbeeps/airbeeps

---

## License

MIT License
