https://github.com/project-david-ai/projectdavid-core
The core source files to this self-hostable successor to the OpenAI Assistants API. To contribute to the core logic, fork or submit pull requests to this repro.
https://github.com/project-david-ai/projectdavid-core
ai-platform assistants-api docker firejail gdpr llm multi-agent openai-compatible orchestration python rag-pipeline self-hosted tool-calling vllm vllm-serve
Last synced: about 2 months ago
JSON representation
The core source files to this self-hostable successor to the OpenAI Assistants API. To contribute to the core logic, fork or submit pull requests to this repro.
- Host: GitHub
- URL: https://github.com/project-david-ai/projectdavid-core
- Owner: project-david-ai
- License: other
- Created: 2024-08-09T17:41:26.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-04-19T02:47:01.000Z (about 2 months ago)
- Last Synced: 2026-04-19T04:30:57.207Z (about 2 months ago)
- Topics: ai-platform, assistants-api, docker, firejail, gdpr, llm, multi-agent, openai-compatible, orchestration, python, rag-pipeline, self-hosted, tool-calling, vllm, vllm-serve
- Language: Python
- Homepage:
- Size: 18.9 MB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Project David — Platform
[](https://polyformproject.org/licenses/noncommercial/1.0.0/)
[](https://hub.docker.com/r/thanosprime/entities-api-api)
[](https://hub.docker.com/r/thanosprime/entities-api-api/tags)
[](https://github.com/frankie336/entities_api/actions/workflows/ci.yml)
**From the lab to enterprise grade orchestration — instantly.**
The open source, GDPR compliant, security audited successor to the OpenAI Assistants API.
Same primitives. Every model. Your infrastructure.
[](https://raw.githubusercontent.com/frankie336/entities_api/master/assets/projectdavid_logo.png)
---
## What is Project David?
Project David is a full-scale, containerized LLM orchestration platform built
around the same primitives as the OpenAI Assistants API — **Assistants, Threads,
Messages, Runs, and Tools** — but without the lock-in.
- **Provider agnostic** — Hyperbolic, TogetherAI, Ollama, or any OpenAI-compatible endpoint
- **Every model** — hosted APIs today, raw local weights tomorrow via Project Uni5
- **Your infrastructure** — fully self-hostable, GDPR compliant, security audited
- **Production grade** — sandboxed code execution (FireJail PTY), multi-agent delegation, file serving with signed URLs, real-time streaming frontend
---
## Why Project David?
| | OpenAI Assistants API | LangChain | Project David |
|---|---|---|---|
| Assistants / Threads / Runs primitives | ✅ | ❌ | ✅ |
| Provider agnostic | ❌ | Partial | ✅ |
| Local model support | ❌ | Partial | ✅ |
| Raw weights → orchestration | ❌ | ❌ | ✅ *(Uni5)* |
| Sandboxed code execution | ✅ Black box | ❌ | ✅ FireJail PTY |
| Multi-agent delegation | Limited | ❌ | ✅ |
| Self-hostable | ❌ | ✅ | ✅ |
| GDPR compliant | ❌ | N/A | ✅ |
| Security audited | N/A | N/A | ✅ |
| Open source | ❌ | ✅ | ✅ |
---
## Quick Start
**1. Install the local package.**
```bash
pip install -e .
```
**2. Build and start the Docker stack.**
```bash
platform-api docker-manager --mode both
```
> 📦 **What gets generated on first run**
>
> | File | What it contains |
> |---|---|
> | `.env` | Unique locally-generated secrets — DB passwords, `DEFAULT_SECRET_KEY`, `SEARXNG_SECRET_KEY` etc. Never committed to version control. |
> | `docker-compose.yml` | A fully-wired Compose file referencing those secrets. |
>
> Both files are created once and left untouched on subsequent runs.
Verify the CLI:
```bash
platform-api --help
```
```
Usage: platform-api [OPTIONS] COMMAND [ARGS]...
Entities API management CLI.
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ configure Update variables in an existing .env without regenerating secrets. │
│ bootstrap-admin Provision the default admin user inside the running api container. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
```
For the full command reference see [Docker orchestration commands →](https://github.com/project-david-ai/projectdavid_docs/blob/master/src/pages/api-infra/docker_commands.md)
---
**3. Provision your admin credentials.**
Set `SPECIAL_DB_URL` before running:
```bash
# Linux / macOS
export SPECIAL_DB_URL=mysql+pymysql://user:password@localhost:3307/entities_db
```
```powershell
# Windows PowerShell
Get-Content .env | ForEach-Object {
if ($_ -match '^\s*([^#][^=]+)=(.*)$') {
[System.Environment]::SetEnvironmentVariable($matches[1].Trim(), $matches[2].Trim())
}
}
```
Then run:
```bash
platform-api bootstrap-admin bootstrap-admin
```
Or explicitly:
```bash
platform-api bootstrap-admin \
--db-url "mysql+pymysql://user:password@localhost:3307/entities_db" \
--email "admin@example.com" \
--name "Default Admin"
```
Expected output:
```
================================================================
✓ Admin API Key Generated
================================================================
Email : admin@example.com
User ID : user_abc123...
Prefix : ad_abc12
----------------------------------------------------------------
API KEY : ad_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
----------------------------------------------------------------
This key will NOT be shown again.
================================================================
```
> ⚠️ **Store this key immediately.** It is shown exactly once and cannot be recovered.
---
**4. Provision your first user.**
```bash
pip install projectdavid
```
```python
import os
from dotenv import load_dotenv
from projectdavid import Entity
load_dotenv()
client = Entity(api_key=os.getenv("ADMIN_API_KEY"))
new_user = client.users.create_user(
full_name="Kevin Flynn",
email="flynn@encom.com",
is_admin=False,
)
print(new_user)
```
Issue the user an API key:
```python
api_key = client.keys.create_key_for_user(
target_user_id=new_user.id,
key_name="The Grid"
)
print(api_key.plain_key)
# ea_z_5YV4zGly50UHKlenc9BgTCQXtE....
```
> ⚠️ **Do not use the admin key for general API calls.**
The user is now ready to connect via the SDK:
```python
client = Entity(api_key=os.getenv("USER_API_KEY"))
```
---
## Architecture
---
## Documentation
| Topic | Link |
|---|---|
| Full Documentation | [docs.projectdavid.co.uk](https://docs.projectdavid.co.uk/docs) |
| SDK Quick Start | [docs.projectdavid.co.uk/docs/sdk-quick-start](https://docs.projectdavid.co.uk/docs/sdk-quick-start) |
| Docker Commands | [docs.projectdavid.co.uk/docs/docker_commands](https://docs.projectdavid.co.uk/docs/docker_commands) |
| Providers | [docs.projectdavid.co.uk/docs/providers](https://docs.projectdavid.co.uk/docs/providers) |
> Full hosted docs: [docs.projectdavid.co.uk](https://docs.projectdavid.co.uk/docs)
---
## Related Repositories
| Repo | Description |
|---|---|
| [projectdavid](https://github.com/project-david-ai/projectdavid) | Python SDK |
| [entities-common](https://github.com/project-david-ai/entities-common) | Shared utilities and validation |
| [david-core](https://github.com/project-david-ai/david-core) | Docker orchestration layer |
| [reference-frontend](https://github.com/project-david-ai/reference-frontend) | Reference streaming frontend |
| [entities_cook_book](https://github.com/project-david-ai/entities_cook_book) | Minimal tested examples |
---
## License
Distributed under the [PolyForm Noncommercial License 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0/).
Commercial licensing available upon request.