https://github.com/project-david-ai/projectdavid

Open source Python SDK for Project David — the GDPR compliant, self-hostable successor to the OpenAI Assistants API.
https://github.com/project-david-ai/projectdavid

ai-platform assisant docker firejail gdpr llm multi-agent openai-compatible orchestration python self-hosted tool-calling

Last synced: 2 months ago
JSON representation

Open source Python SDK for Project David — the GDPR compliant, self-hostable successor to the OpenAI Assistants API.

Host: GitHub
URL: https://github.com/project-david-ai/projectdavid
Owner: project-david-ai
License: other
Created: 2025-03-15T15:38:16.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2026-03-30T04:50:33.000Z (3 months ago)
Last Synced: 2026-03-30T06:57:03.475Z (3 months ago)
Topics: ai-platform, assisant, docker, firejail, gdpr, llm, multi-agent, openai-compatible, orchestration, python, self-hosted, tool-calling
Language: Python
Homepage:
Size: 1.98 MB
Stars: 0
Watchers: 1
Forks: 1
Open Issues: 3
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

          # projectdavid — Python SDK

[![PyPI](https://img.shields.io/pypi/v/projectdavid)](https://pypi.org/project/projectdavid/)

[![Downloads](https://static.pepy.tech/badge/projectdavid)](https://pepy.tech/project/projectdavid)

[![License: PolyForm Noncommercial](https://img.shields.io/badge/license-PolyForm%20Noncommercial%201.0.0-blue.svg)](https://polyformproject.org/licenses/noncommercial/1.0.0/)

[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)

[![Lint, Test, Tag, Publish Status](https://github.com/frankie336/projectdavid/actions/workflows/test_tag_release.yml/badge.svg)](https://github.com/frankie336/projectdavid/actions/workflows/test_tag_release.yml)

---

**The Python SDK for Project David — the open source, GDPR compliant successor to the OpenAI Assistants API.**

Same primitives. Every model. Your infrastructure.

---

## 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. Point at any inference provider and the platform normalizes the stream.

- **Every model** — hosted APIs today, raw local weights tomorrow. Bring your own model.

- **Your infrastructure** — fully self-hostable, open source, GDPR compliant, security audited.

- **Production grade** — sandboxed code execution (FireJail), multi-agent delegation, file serving with signed URLs, real-time streaming frontend.

> **Project Uni5** — the next milestone. `transformers`, GGUF, and vLLM adapters that mean a model straight off a training run has a full orchestration platform in minutes. From the lab to enterprise grade orchestration — instantly.

---

### Project Activity & Reach

| Metric | Status |

| :--- | :--- |

| **Total Downloads** | ![Total Downloads](https://static.pepy.tech/badge/projectdavid) |

| **Monthly Reach** | ![Monthly](https://img.shields.io/pypi/dm/projectdavid?color=blue&label=pypi%20downloads) |

| **Open Source Activity** | ![GitHub last commit](https://img.shields.io/github/last-commit/frankie336/projectdavid) |

| **Analytics** | [View Live Download Trends on ClickPy →](https://clickpy.clickhouse.com/dashboard/projectdavid) |

---

## Installation

```bash

pip install projectdavid

```

**Requirements:** Python 3.10+ · A running Project David platform instance

---

## Quick Start

```python

import os

from dotenv import load_dotenv

from projectdavid import Entity

load_dotenv()

client = Entity(

    base_url=os.getenv("BASE_URL"),        # default: http://localhost:80

    api_key=os.getenv("ENTITIES_API_KEY"),

)

# Create an assistant

assistant = client.assistants.create_assistant(

    name="my_assistant",

    instructions="You are a helpful AI assistant.",

)

# Create a thread and send a message

thread = client.threads.create_thread()

message = client.messages.create_message(

    thread_id=thread.id,

    role="user",

    content="Tell me about the latest trends in AI.",

    assistant_id=assistant.id,

)

# Create a run

run = client.runs.create_run(

    assistant_id=assistant.id,

    thread_id=thread.id,

)

# Stream the response

stream = client.synchronous_inference_stream

stream.setup(

    user_id=os.getenv("ENTITIES_USER_ID"),

    thread_id=thread.id,

    assistant_id=assistant.id,

    message_id=message.id,

    run_id=run.id,

    api_key=os.getenv("PROVIDER_API_KEY"),

)

for chunk in stream.stream_chunks(

    model="hyperbolic/deepseek-ai/DeepSeek-V3-0324",

    timeout_per_chunk=15.0,

):

    content = chunk.get("content", "")

    if content:

        print(content, end="", flush=True)

```

See the [Quick Start guide](https://docs.projectdavid.co.uk/docs/sdk-quick-start) for the event-driven interface, tool calling, and advanced usage.

---

## 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 | ❌ | ✅ | ✅ |

| **Community Adoption** | Proprietary | High | ![Total Downloads](https://static.pepy.tech/badge/projectdavid) |

---

## Supported Inference Providers

[Full list of supported providers and endpoints →](https://github.com/project-david-ai/projectdavid_docs/blob/master/src/pages/providers/providers.md)

Works with any OpenAI-compatible endpoint out of the box — including Ollama for fully local inference.

---

## Environment Variables

| Variable | Description                                        |

|---|----------------------------------------------------|

| `ENTITIES_API_KEY` | Your Entities API key                              |

| `ENTITIES_USER_ID` | Your user ID                                       |

| `BASE_URL` | Platform base URL (default: `http://localhost:80`) |

| `PROVIDER_API_KEY` | Your inference provider API key                    |

---

## Documentation

## Documentation

| Topic | Link |

|---|---|

| Full Documentation | [docs.projectdavid.co.uk](https://docs.projectdavid.co.uk/docs) |

| Quick Start | [docs.projectdavid.co.uk/docs/sdk-quick-start](https://docs.projectdavid.co.uk/docs/sdk-quick-start) |

| Assistants | [docs.projectdavid.co.uk/docs/sdk-assistants](https://docs.projectdavid.co.uk/docs/sdk-assistants) |

| Threads | [docs.projectdavid.co.uk/docs/sdk-threads](https://docs.projectdavid.co.uk/docs/sdk-threads) |

| Messages | [docs.projectdavid.co.uk/docs/sdk-messages](https://docs.projectdavid.co.uk/docs/sdk-messages) |

| Runs | [docs.projectdavid.co.uk/docs/sdk-runs](https://docs.projectdavid.co.uk/docs/sdk-runs) |

| Inference | [docs.projectdavid.co.uk/docs/sdk-inference](https://docs.projectdavid.co.uk/docs/sdk-inference) |

| Tools | [docs.projectdavid.co.uk/docs/sdk-tools](https://docs.projectdavid.co.uk/docs/sdk-tools) |

| Function Calls | [docs.projectdavid.co.uk/docs/sdk-function-calls](https://docs.projectdavid.co.uk/docs/12_sdk-function-calls) |

| Code Interpreter | [docs.projectdavid.co.uk/docs/sdk-code-interpreter](https://docs.projectdavid.co.uk/docs/sdk-code-interpreter) |

| Files | [docs.projectdavid.co.uk/docs/sdk-files](https://docs.projectdavid.co.uk/docs/10_sdk-files) |

| Vector Store | [docs.projectdavid.co.uk/docs/sdk-vector-store](https://docs.projectdavid.co.uk/docs/11_sdk-vector-store) |

| Stream Contract | [docs.projectdavid.co.uk/docs/sdk-stream-contract](https://docs.projectdavid.co.uk/docs/sdk-stream-contract) |

| Providers | [docs.projectdavid.co.uk/docs/providers](https://docs.projectdavid.co.uk/docs/providers) |

[Full SDK documentation →](https://github.com/project-david-ai/projectdavid_docs/tree/master/src/pages/sdk)

> Full hosted docs coming at `docs.projectdavid.co.uk`

---

## Related Repositories

| Repo | Description |

|---|---|

| [projectdavid-core](https://github.com/project-david-ai/projectdavid-core) | Runtime API engine |

| [projectdavid-platform](https://github.com/project-david-ai/projectdavid-platform) | Docker orchestration layer |

| [projectdavid-common](https://github.com/project-david-ai/projectdavid-common) | Shared utilities and validation |

| [projectdavid-docs](https://github.com/project-david-ai/projectdavid-docs) | Documentation site |

| [entities_cook_book](https://github.com/project-david-ai/entities_cook_book) | Minimal tested examples |

---

---

## License

[PolyForm Noncommercial 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0/)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/project-david-ai/projectdavid

Awesome Lists containing this project

README