projectdavid-platform 1.8.0__tar.gz

projectdavid_platform-1.8.0/LICENSE

@@ -0,0 +1,131 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

projectdavid_platform-1.8.0/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: projectdavid-platform
+Version: 1.8.0
+Summary: Deployment orchestrator for the Project David / Entities platform
+Author-email: Francis Neequaye Armah <francis.neequaye@projectdavid.co.uk>
+License: PolyForm Noncommercial 1.0.0
+Keywords: Entities,ProjectDavid,Orchestration,Docker,Deployment,LLM
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML>=5.4
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: black>=23.3; extra == "dev"
+Requires-Dist: isort>=5.12; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: pytest>=7.2; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# Project David Platform
+
+[![Docker Pulls](https://img.shields.io/docker/pulls/thanosprime/entities-api-api?label=API%20Pulls&logo=docker&style=flat-square)](https://hub.docker.com/r/thanosprime/entities-api-api)
+[![CI](https://github.com/project-david-ai/platform-docker/actions/workflows/ci.yml/badge.svg)](https://github.com/project-david-ai/platform-docker/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/projectdavid-platform?style=flat-square)](https://pypi.org/project/projectdavid-platform/)
+[![License: PolyForm Noncommercial](https://img.shields.io/badge/license-PolyForm%20Noncommercial%201.0.0-blue.svg)](https://polyformproject.org/licenses/noncommercial/1.0.0/)
+
+Deployment orchestrator for the Project David / Entities platform. Provides a single command to bring up the complete infrastructure stack, including database, vector store, search, observability, secure code execution, and optional GPU inference services.
+
+---
+
+## Installation
+
+```bash
+pip install projectdavid-platform
+```
+
+No repository clone required. The compose files and configuration templates are bundled with the package.
+
+---
+
+## Quick Start
+
+```bash
+platform --mode up
+```
+
+On first run this will:
+
+- Generate a `.env` file with unique, cryptographically secure secrets
+- Prompt for optional values (HuggingFace token for gated model access)
+- Pull all required Docker images
+- Start the full stack in detached mode
+
+### GPU stack (vLLM + Ollama)
+
+```bash
+platform --mode up --gpu
+```
+
+Requires an NVIDIA GPU with the [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html) installed.
+
+---
+
+## Stack Services
+
+| Service | Image | Description |
+|---|---|---|
+| `api` | `thanosprime/entities-api-api` | FastAPI backend exposing assistant and inference endpoints |
+| `sandbox` | `thanosprime/entities-api-sandbox` | Secure code execution environment |
+| `db` | `mysql:8.0` | Relational persistence |
+| `qdrant` | `qdrant/qdrant` | Vector database for embeddings and RAG |
+| `redis` | `redis:7` | Cache and message broker |
+| `searxng` | `searxng/searxng` | Self-hosted web search |
+| `browser` | `browserless/chromium` | Headless browser for web agent tooling |
+| `otel-collector` | `otel/opentelemetry-collector-contrib` | Telemetry collection |
+| `jaeger` | `jaegertracing/all-in-one` | Distributed tracing UI |
+| `samba` | `dperson/samba` | File sharing for uploaded documents |
+| `ollama` | `ollama/ollama` | Local LLM inference (GPU stack only) |
+| `vllm` | `vllm/vllm-openai` | High-throughput GPU inference (GPU stack only) |
+
+---
+
+## Prerequisites
+
+- Docker and Docker Compose
+- Python 3.9 or later
+- NVIDIA GPU with NVIDIA Container Toolkit (GPU stack only)
+
+---
+
+## Lifecycle Commands
+
+### Start the stack
+
+```bash
+platform --mode up
+```
+
+### Start with GPU services
+
+```bash
+platform --mode up --gpu
+```
+
+### Stop the stack
+
+```bash
+platform --mode down_only
+```
+
+### Stop and remove all volumes
+
+```bash
+platform --mode down_only --clear-volumes
+```
+
+### Force recreate all containers
+
+```bash
+platform --mode up --force-recreate
+```
+
+### Stream logs
+
+```bash
+platform --mode logs --follow
+```
+
+### Destroy all stack data
+
+```bash
+platform --nuke
+```
+
+Requires interactive confirmation. Cannot be undone.
+
+---
+
+## Configuration
+
+### Setting optional values
+
+Optional values such as the HuggingFace token can be set at any time without regenerating secrets:
+
+```bash
+platform configure --set HF_TOKEN=hf_abc123
+platform configure --set VLLM_MODEL=Qwen/Qwen2.5-VL-7B-Instruct
+```
+
+Or interactively:
+
+```bash
+platform configure --interactive
+```
+
+### Rotating secrets
+
+The orchestrator warns when a change requires additional steps to apply safely. Database password rotation requires clearing the initialised volume:
+
+```bash
+platform configure --set MYSQL_PASSWORD=<new_password>
+# Follow the warning instructions printed by the command
+```
+
+---
+
+## Post-startup Provisioning
+
+Once the stack is running, provision the admin user and default assistant:
+
+```bash
+# Bootstrap the default admin user
+platform bootstrap-admin
+
+# Create a regular user
+platform create-user --email user@example.com --name "Alice"
+
+# Set up the default assistant
+platform setup-assistant --api-key ad_... --user-id usr_...
+```
+
+Full provisioning walkthrough: [`docs/boot_strap.md`](docs/boot_strap.md)
+
+---
+
+## Docker Images
+
+Both owned images are published to Docker Hub and updated automatically on each release of the source repository.
+
+- [thanosprime/entities-api-api](https://hub.docker.com/r/thanosprime/entities-api-api)
+- [thanosprime/entities-api-sandbox](https://hub.docker.com/r/thanosprime/entities-api-sandbox)
+
+---
+
+## Related Repositories
+
+| Repository | Purpose |
+|---|---|
+| [entities_api](https://github.com/frankie336/entities_api) | FastAPI backend source code, inference engine, and tooling framework |
+| [projectdavid](https://github.com/frankie336/projectdavid) | Python SDK for interacting with the Entities API |
+| [platform-docker](https://github.com/project-david-ai/platform-docker) | This repository — deployment orchestration |
+
+---
+
+## Working with the Source Code
+
+This repository is intended for deploying prebuilt images. To develop, extend, or contribute to the platform source:
+
+```bash
+git clone https://github.com/frankie336/entities_api.git
+cd entities_api
+pip install -e .
+entities-api docker-manager --mode up
+```
+
+---
+
+## License
+
+Distributed under the [PolyForm Noncommercial License 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0/).
+Commercial licensing is available on request.

projectdavid_platform-1.8.0/README.md

@@ -0,0 +1,202 @@
+# Project David Platform
+
+[![Docker Pulls](https://img.shields.io/docker/pulls/thanosprime/entities-api-api?label=API%20Pulls&logo=docker&style=flat-square)](https://hub.docker.com/r/thanosprime/entities-api-api)
+[![CI](https://github.com/project-david-ai/platform-docker/actions/workflows/ci.yml/badge.svg)](https://github.com/project-david-ai/platform-docker/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/projectdavid-platform?style=flat-square)](https://pypi.org/project/projectdavid-platform/)
+[![License: PolyForm Noncommercial](https://img.shields.io/badge/license-PolyForm%20Noncommercial%201.0.0-blue.svg)](https://polyformproject.org/licenses/noncommercial/1.0.0/)
+
+Deployment orchestrator for the Project David / Entities platform. Provides a single command to bring up the complete infrastructure stack, including database, vector store, search, observability, secure code execution, and optional GPU inference services.
+
+---
+
+## Installation
+
+```bash
+pip install projectdavid-platform
+```
+
+No repository clone required. The compose files and configuration templates are bundled with the package.
+
+---
+
+## Quick Start
+
+```bash
+platform --mode up
+```
+
+On first run this will:
+
+- Generate a `.env` file with unique, cryptographically secure secrets
+- Prompt for optional values (HuggingFace token for gated model access)
+- Pull all required Docker images
+- Start the full stack in detached mode
+
+### GPU stack (vLLM + Ollama)
+
+```bash
+platform --mode up --gpu
+```
+
+Requires an NVIDIA GPU with the [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html) installed.
+
+---
+
+## Stack Services
+
+| Service | Image | Description |
+|---|---|---|
+| `api` | `thanosprime/entities-api-api` | FastAPI backend exposing assistant and inference endpoints |
+| `sandbox` | `thanosprime/entities-api-sandbox` | Secure code execution environment |
+| `db` | `mysql:8.0` | Relational persistence |
+| `qdrant` | `qdrant/qdrant` | Vector database for embeddings and RAG |
+| `redis` | `redis:7` | Cache and message broker |
+| `searxng` | `searxng/searxng` | Self-hosted web search |
+| `browser` | `browserless/chromium` | Headless browser for web agent tooling |
+| `otel-collector` | `otel/opentelemetry-collector-contrib` | Telemetry collection |
+| `jaeger` | `jaegertracing/all-in-one` | Distributed tracing UI |
+| `samba` | `dperson/samba` | File sharing for uploaded documents |
+| `ollama` | `ollama/ollama` | Local LLM inference (GPU stack only) |
+| `vllm` | `vllm/vllm-openai` | High-throughput GPU inference (GPU stack only) |
+
+---
+
+## Prerequisites
+
+- Docker and Docker Compose
+- Python 3.9 or later
+- NVIDIA GPU with NVIDIA Container Toolkit (GPU stack only)
+
+---
+
+## Lifecycle Commands
+
+### Start the stack
+
+```bash
+platform --mode up
+```
+
+### Start with GPU services
+
+```bash
+platform --mode up --gpu
+```
+
+### Stop the stack
+
+```bash
+platform --mode down_only
+```
+
+### Stop and remove all volumes
+
+```bash
+platform --mode down_only --clear-volumes
+```
+
+### Force recreate all containers
+
+```bash
+platform --mode up --force-recreate
+```
+
+### Stream logs
+
+```bash
+platform --mode logs --follow
+```
+
+### Destroy all stack data
+
+```bash
+platform --nuke
+```
+
+Requires interactive confirmation. Cannot be undone.
+
+---
+
+## Configuration
+
+### Setting optional values
+
+Optional values such as the HuggingFace token can be set at any time without regenerating secrets:
+
+```bash
+platform configure --set HF_TOKEN=hf_abc123
+platform configure --set VLLM_MODEL=Qwen/Qwen2.5-VL-7B-Instruct
+```
+
+Or interactively:
+
+```bash
+platform configure --interactive
+```
+
+### Rotating secrets
+
+The orchestrator warns when a change requires additional steps to apply safely. Database password rotation requires clearing the initialised volume:
+
+```bash
+platform configure --set MYSQL_PASSWORD=<new_password>
+# Follow the warning instructions printed by the command
+```
+
+---
+
+## Post-startup Provisioning
+
+Once the stack is running, provision the admin user and default assistant:
+
+```bash
+# Bootstrap the default admin user
+platform bootstrap-admin
+
+# Create a regular user
+platform create-user --email user@example.com --name "Alice"
+
+# Set up the default assistant
+platform setup-assistant --api-key ad_... --user-id usr_...
+```
+
+Full provisioning walkthrough: [`docs/boot_strap.md`](docs/boot_strap.md)
+
+---
+
+## Docker Images
+
+Both owned images are published to Docker Hub and updated automatically on each release of the source repository.
+
+- [thanosprime/entities-api-api](https://hub.docker.com/r/thanosprime/entities-api-api)
+- [thanosprime/entities-api-sandbox](https://hub.docker.com/r/thanosprime/entities-api-sandbox)
+
+---
+
+## Related Repositories
+
+| Repository | Purpose |
+|---|---|
+| [entities_api](https://github.com/frankie336/entities_api) | FastAPI backend source code, inference engine, and tooling framework |
+| [projectdavid](https://github.com/frankie336/projectdavid) | Python SDK for interacting with the Entities API |
+| [platform-docker](https://github.com/project-david-ai/platform-docker) | This repository — deployment orchestration |
+
+---
+
+## Working with the Source Code
+
+This repository is intended for deploying prebuilt images. To develop, extend, or contribute to the platform source:
+
+```bash
+git clone https://github.com/frankie336/entities_api.git
+cd entities_api
+pip install -e .
+entities-api docker-manager --mode up
+```
+
+---
+
+## License
+
+Distributed under the [PolyForm Noncommercial License 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0/).
+Commercial licensing is available on request.

projectdavid_platform-1.8.0/projectdavid_platform/__init__.py

@@ -0,0 +1,2 @@
+# projectdavid_platform/__init__.py
+__version__ = "1.3.0"

projectdavid_platform-1.8.0/projectdavid_platform/docker-compose.gpu.yml

@@ -0,0 +1,78 @@
+# docker-compose.gpu.yml
+#
+# GPU service overrides — opt-in extension for users with NVIDIA hardware.
+#
+# USAGE:
+#   entities-dev --mode up --gpu
+#
+# Or manually:
+#   docker compose -f docker-compose.yml -f docker-compose.gpu.yml up -d
+#
+# REQUIREMENTS:
+#   - NVIDIA GPU with drivers installed
+#   - NVIDIA Container Toolkit (https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html)
+#   - HF_TOKEN set in .env (for gated model downloads)
+#   - HF_CACHE_PATH set in .env (auto-resolved by entities-dev on first run)
+#
+# To set HF_TOKEN after initial setup:
+#   entities-dev configure --set HF_TOKEN=hf_abc123
+
+services:
+  ollama:
+    image: ollama/ollama:latest
+    container_name: ollama
+    restart: unless-stopped
+    ports:
+      - "11434:11434"
+    volumes:
+      - ollama_data:/root/.ollama
+    networks:
+      - my_custom_network
+
+  vllm:
+    image: vllm/vllm-openai:latest
+    container_name: vllm_server
+    restart: unless-stopped
+    runtime: nvidia
+    environment:
+      - NVIDIA_VISIBLE_DEVICES=all
+      # HF_TOKEN is optional — stack starts without it but gated model
+      # downloads will fail. Set via: entities-dev configure --set HF_TOKEN=hf_abc123
+      - HF_TOKEN=${HF_TOKEN}
+    volumes:
+      # HF_CACHE_PATH uses :- fallback to avoid multi-colon parse error in volume syntax.
+      # The orchestrator always sets this before starting — fallback only fires if
+      # docker compose up is run directly without going through entities-dev.
+      - "${HF_CACHE_PATH:-~/.cache/huggingface}:/root/.cache/huggingface"
+    ports:
+      - "8001:8000"
+    command: >
+      --model ${VLLM_MODEL:-Qwen/Qwen2.5-VL-3B-Instruct}
+      --dtype float16
+      --quantization fp8
+      --max-model-len 4096
+      --gpu-memory-utilization 0.85
+    networks:
+      - my_custom_network
+    deploy:
+      resources:
+        reservations:
+          devices:
+            - driver: nvidia
+              count: all
+              capabilities: [gpu]
+
+  # Override api service to point at the real GPU service URLs
+  # instead of the localhost stubs in the base compose file.
+  api:
+    environment:
+      - OLLAMA_BASE_URL=http://ollama:11434/v1
+      - VLLM_BASE_URL=http://vllm_server:8000
+    depends_on:
+      ollama:
+        condition: service_started
+      vllm:
+        condition: service_started
+
+volumes:
+  ollama_data:

projectdavid_platform-1.8.0/projectdavid_platform/docker-compose.yml

@@ -0,0 +1,212 @@
+services:
+  db:
+    image: mysql:8.0
+    container_name: my_mysql_cosmic_catalyst
+    restart: always
+    environment:
+      MYSQL_ROOT_PASSWORD: "${MYSQL_ROOT_PASSWORD:?MYSQL_ROOT_PASSWORD is not set. Run: entities-dev --mode up}"
+      MYSQL_DATABASE: entities_db
+      MYSQL_USER: api_user
+      MYSQL_PASSWORD: "${MYSQL_PASSWORD:?MYSQL_PASSWORD is not set. Run: entities-dev --mode up}"
+    volumes:
+      - mysql_data:/var/lib/mysql
+    ports:
+      - "3307:3306"
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - my_custom_network
+
+  qdrant:
+    image: qdrant/qdrant:latest
+    container_name: qdrant_server
+    restart: always
+    ports:
+      - "6333:6333"
+      - "6334:6334"
+    volumes:
+      - qdrant_storage:/qdrant/storage
+    environment:
+      QDRANT__STORAGE__STORAGE_PATH: "/qdrant/storage"
+      QDRANT__SERVICE__GRPC_PORT: "6334"
+      QDRANT__LOG_LEVEL: "INFO"
+    networks:
+      - my_custom_network
+
+  redis:
+    image: redis:7
+    container_name: redis
+    restart: unless-stopped
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis_data:/data
+    networks:
+      - my_custom_network
+
+  browser:
+    image: ghcr.io/browserless/chromium:latest
+    container_name: browserless_chromium
+    restart: always
+    ports:
+      - "3000:3000"
+    environment:
+      - MAX_CONCURRENT_SESSIONS=10
+      - CONNECTION_TIMEOUT=60000
+    networks:
+      - my_custom_network
+
+  searxng:
+    image: searxng/searxng:latest
+    container_name: searxng
+    restart: unless-stopped
+    ports:
+      - "8080:8080"
+    volumes:
+      - ./docker/searxng:/etc/searxng
+    environment:
+      - SEARXNG_BASE_URL=http://localhost:8080/
+      - "SEARXNG_SECRET_KEY=${SEARXNG_SECRET_KEY:?SEARXNG_SECRET_KEY is not set. Run: entities-dev --mode up}"
+    depends_on:
+      - redis
+    networks:
+      - my_custom_network
+
+  otel-collector:
+    image: otel/opentelemetry-collector-contrib:latest
+    container_name: otel_collector
+    restart: always
+    command: ["--config=/etc/otel-config.yaml"]
+    volumes:
+      - ./docker/otel/otel-config.yaml:/etc/otel-config.yaml
+    ports:
+      - "4317:4317"
+      - "4318:4318"
+    depends_on:
+      - jaeger
+    networks:
+      - my_custom_network
+
+  jaeger:
+    image: jaegertracing/all-in-one:latest
+    container_name: jaeger_ui
+    restart: always
+    environment:
+      - COLLECTOR_OTLP_ENABLED=true
+    ports:
+      - "16686:16686"
+      - "14250:14250"
+    networks:
+      - my_custom_network
+
+  api:
+    # Pre-built image from Docker Hub — do not add build: context here.
+    # To build from source use the entities_api dev repo instead.
+    image: thanosprime/entities-api-api:latest
+    container_name: fastapi_cosmic_catalyst
+    restart: always
+    env_file:
+      - .env
+    environment:
+      - DATABASE_URL=${DATABASE_URL}
+      - AUTO_MIGRATE=1
+      - SANDBOX_SERVER_URL=http://sandbox:8000
+      - QDRANT_URL=http://qdrant:6333
+      - REDIS_URL=redis://redis:6379/0
+      - BROWSER_WS_ENDPOINT=ws://browser:3000
+      - "DEFAULT_SECRET_KEY=${DEFAULT_SECRET_KEY:?DEFAULT_SECRET_KEY is not set. Run: entities-dev --mode up}"
+      - SEARXNG_URL=http://searxng:8080
+      - OTEL_SERVICE_NAME=entities-api
+      - OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4317
+      - OTEL_EXPORTER_OTLP_PROTOCOL=grpc
+      - OTEL_TRACES_EXPORTER=otlp
+      - OTEL_METRICS_EXPORTER=none
+      - OTEL_LOGS_EXPORTER=none
+      # Ollama and vLLM base URLs — resolved to localhost stubs when GPU
+      # services are not running. Override via docker-compose.gpu.yml.
+      - OLLAMA_BASE_URL=http://localhost:11434/v1
+      - VLLM_BASE_URL=http://localhost:8001
+      # Container-internal mount point — always fixed regardless of host SHARED_PATH
+      - SHARED_PATH=/app/shared_data
+    ports:
+      - "9000:9000"
+    volumes:
+      # Mount scripts so bootstrap/create-user/setup-assistant commands work
+      - ./scripts:/app/scripts
+      # SHARED_PATH uses :- fallback to avoid multi-colon parse error in volume syntax.
+      # The orchestrator always sets this before starting — fallback only fires if
+      # docker compose up is run directly without going through entities-dev.
+      - "${SHARED_PATH:-./shared_data}:/app/shared_data"
+    depends_on:
+      db:
+        condition: service_healthy
+      sandbox:
+        condition: service_started
+      qdrant:
+        condition: service_started
+      redis:
+        condition: service_started
+      browser:
+        condition: service_started
+      searxng:
+        condition: service_started
+      otel-collector:
+        condition: service_started
+    networks:
+      - my_custom_network
+
+  sandbox:
+    # Pre-built image from Docker Hub — do not add build: context here.
+    image: thanosprime/entities-api-sandbox:latest
+    container_name: sandbox_api
+    restart: always
+    env_file:
+      - .env
+    cap_add:
+      - SYS_ADMIN
+    security_opt:
+      - seccomp:unconfined
+    devices:
+      - /dev/fuse
+    ports:
+      - "8000:8000"
+    volumes:
+      - /tmp/sandbox_logs:/app/logs
+    depends_on:
+      db:
+        condition: service_healthy
+    networks:
+      - my_custom_network
+
+  samba:
+    image: dperson/samba
+    container_name: samba_server
+    restart: unless-stopped
+    environment:
+      USERID: ${SAMBA_USERID:-1000}
+      GROUPID: ${SAMBA_GROUPID:-1000}
+      TZ: UTC
+      # References the generated secret — never the hardcoded literal "default"
+      USER: "samba_user;${SMBCLIENT_PASSWORD:?SMBCLIENT_PASSWORD is not set. Run: entities-dev --mode up}"
+      SHARE: "cosmic_share;/samba/share;yes;no;no;samba_user"
+      GLOBAL: "server min protocol = NT1\\nserver max protocol = SMB3"
+    ports:
+      - "139:139"
+      - "1445:445"
+    volumes:
+      # Same fallback rationale as api service above
+      - "${SHARED_PATH:-./shared_data}:/samba/share"
+    networks:
+      - my_custom_network
+
+volumes:
+  mysql_data:
+  qdrant_storage:
+  redis_data:
+
+networks:
+  my_custom_network:
+    driver: bridge

projectdavid_platform-1.8.0/projectdavid_platform.egg-info/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: projectdavid-platform
+Version: 1.8.0
+Summary: Deployment orchestrator for the Project David / Entities platform
+Author-email: Francis Neequaye Armah <francis.neequaye@projectdavid.co.uk>
+License: PolyForm Noncommercial 1.0.0
+Keywords: Entities,ProjectDavid,Orchestration,Docker,Deployment,LLM
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML>=5.4
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: black>=23.3; extra == "dev"
+Requires-Dist: isort>=5.12; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: pytest>=7.2; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# Project David Platform
+
+[![Docker Pulls](https://img.shields.io/docker/pulls/thanosprime/entities-api-api?label=API%20Pulls&logo=docker&style=flat-square)](https://hub.docker.com/r/thanosprime/entities-api-api)
+[![CI](https://github.com/project-david-ai/platform-docker/actions/workflows/ci.yml/badge.svg)](https://github.com/project-david-ai/platform-docker/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/projectdavid-platform?style=flat-square)](https://pypi.org/project/projectdavid-platform/)
+[![License: PolyForm Noncommercial](https://img.shields.io/badge/license-PolyForm%20Noncommercial%201.0.0-blue.svg)](https://polyformproject.org/licenses/noncommercial/1.0.0/)
+
+Deployment orchestrator for the Project David / Entities platform. Provides a single command to bring up the complete infrastructure stack, including database, vector store, search, observability, secure code execution, and optional GPU inference services.
+
+---
+
+## Installation
+
+```bash
+pip install projectdavid-platform
+```
+
+No repository clone required. The compose files and configuration templates are bundled with the package.
+
+---
+
+## Quick Start
+
+```bash
+platform --mode up
+```
+
+On first run this will:
+
+- Generate a `.env` file with unique, cryptographically secure secrets
+- Prompt for optional values (HuggingFace token for gated model access)
+- Pull all required Docker images
+- Start the full stack in detached mode
+
+### GPU stack (vLLM + Ollama)
+
+```bash
+platform --mode up --gpu
+```
+
+Requires an NVIDIA GPU with the [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html) installed.
+
+---
+
+## Stack Services
+
+| Service | Image | Description |
+|---|---|---|
+| `api` | `thanosprime/entities-api-api` | FastAPI backend exposing assistant and inference endpoints |
+| `sandbox` | `thanosprime/entities-api-sandbox` | Secure code execution environment |
+| `db` | `mysql:8.0` | Relational persistence |
+| `qdrant` | `qdrant/qdrant` | Vector database for embeddings and RAG |
+| `redis` | `redis:7` | Cache and message broker |
+| `searxng` | `searxng/searxng` | Self-hosted web search |
+| `browser` | `browserless/chromium` | Headless browser for web agent tooling |
+| `otel-collector` | `otel/opentelemetry-collector-contrib` | Telemetry collection |
+| `jaeger` | `jaegertracing/all-in-one` | Distributed tracing UI |
+| `samba` | `dperson/samba` | File sharing for uploaded documents |
+| `ollama` | `ollama/ollama` | Local LLM inference (GPU stack only) |
+| `vllm` | `vllm/vllm-openai` | High-throughput GPU inference (GPU stack only) |
+
+---
+
+## Prerequisites
+
+- Docker and Docker Compose
+- Python 3.9 or later
+- NVIDIA GPU with NVIDIA Container Toolkit (GPU stack only)
+
+---
+
+## Lifecycle Commands
+
+### Start the stack
+
+```bash
+platform --mode up
+```
+
+### Start with GPU services
+
+```bash
+platform --mode up --gpu
+```
+
+### Stop the stack
+
+```bash
+platform --mode down_only
+```
+
+### Stop and remove all volumes
+
+```bash
+platform --mode down_only --clear-volumes
+```
+
+### Force recreate all containers
+
+```bash
+platform --mode up --force-recreate
+```
+
+### Stream logs
+
+```bash
+platform --mode logs --follow
+```
+
+### Destroy all stack data
+
+```bash
+platform --nuke
+```
+
+Requires interactive confirmation. Cannot be undone.
+
+---
+
+## Configuration
+
+### Setting optional values
+
+Optional values such as the HuggingFace token can be set at any time without regenerating secrets:
+
+```bash
+platform configure --set HF_TOKEN=hf_abc123
+platform configure --set VLLM_MODEL=Qwen/Qwen2.5-VL-7B-Instruct
+```
+
+Or interactively:
+
+```bash
+platform configure --interactive
+```
+
+### Rotating secrets
+
+The orchestrator warns when a change requires additional steps to apply safely. Database password rotation requires clearing the initialised volume:
+
+```bash
+platform configure --set MYSQL_PASSWORD=<new_password>
+# Follow the warning instructions printed by the command
+```
+
+---
+
+## Post-startup Provisioning
+
+Once the stack is running, provision the admin user and default assistant:
+
+```bash
+# Bootstrap the default admin user
+platform bootstrap-admin
+
+# Create a regular user
+platform create-user --email user@example.com --name "Alice"
+
+# Set up the default assistant
+platform setup-assistant --api-key ad_... --user-id usr_...
+```
+
+Full provisioning walkthrough: [`docs/boot_strap.md`](docs/boot_strap.md)
+
+---
+
+## Docker Images
+
+Both owned images are published to Docker Hub and updated automatically on each release of the source repository.
+
+- [thanosprime/entities-api-api](https://hub.docker.com/r/thanosprime/entities-api-api)
+- [thanosprime/entities-api-sandbox](https://hub.docker.com/r/thanosprime/entities-api-sandbox)
+
+---
+
+## Related Repositories
+
+| Repository | Purpose |
+|---|---|
+| [entities_api](https://github.com/frankie336/entities_api) | FastAPI backend source code, inference engine, and tooling framework |
+| [projectdavid](https://github.com/frankie336/projectdavid) | Python SDK for interacting with the Entities API |
+| [platform-docker](https://github.com/project-david-ai/platform-docker) | This repository — deployment orchestration |
+
+---
+
+## Working with the Source Code
+
+This repository is intended for deploying prebuilt images. To develop, extend, or contribute to the platform source:
+
+```bash
+git clone https://github.com/frankie336/entities_api.git
+cd entities_api
+pip install -e .
+entities-api docker-manager --mode up
+```
+
+---
+
+## License
+
+Distributed under the [PolyForm Noncommercial License 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0/).
+Commercial licensing is available on request.

projectdavid_platform-1.8.0/projectdavid_platform.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+projectdavid_platform/__init__.py
+projectdavid_platform/docker-compose.gpu.yml
+projectdavid_platform/docker-compose.yml
+projectdavid_platform.egg-info/PKG-INFO
+projectdavid_platform.egg-info/SOURCES.txt
+projectdavid_platform.egg-info/dependency_links.txt
+projectdavid_platform.egg-info/entry_points.txt
+projectdavid_platform.egg-info/requires.txt
+projectdavid_platform.egg-info/top_level.txt

projectdavid_platform-1.8.0/projectdavid_platform.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

projectdavid_platform-1.8.0/projectdavid_platform.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pdavid = start_orchestration:entry_point

projectdavid_platform-1.8.0/projectdavid_platform.egg-info/requires.txt

@@ -0,0 +1,11 @@
+PyYAML>=5.4
+python-dotenv>=1.0
+typer>=0.9.0
+
+[dev]
+black>=23.3
+isort>=5.12
+ruff>=0.4.0
+pytest>=7.2
+build
+twine

projectdavid_platform-1.8.0/projectdavid_platform.egg-info/top_level.txt

@@ -0,0 +1 @@
+projectdavid_platform

projectdavid_platform-1.8.0/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "projectdavid-platform"
+version = "1.8.0"
+description = "Deployment orchestrator for the Project David / Entities platform"
+readme = "README.md"
+authors = [
+  { name = "Francis Neequaye Armah", email = "francis.neequaye@projectdavid.co.uk" }
+]
+license = { text = "PolyForm Noncommercial 1.0.0" }
+requires-python = ">=3.9"
+keywords = ["Entities", "ProjectDavid", "Orchestration", "Docker", "Deployment", "LLM"]
+
+dependencies = [
+  "PyYAML>=5.4",
+  "python-dotenv>=1.0",
+  "typer>=0.9.0",
+]
+
+[project.scripts]
+pdavid = "start_orchestration:entry_point"
+
+[project.optional-dependencies]
+dev = [
+  "black>=23.3",
+  "isort>=5.12",
+  "ruff>=0.4.0",
+  "pytest>=7.2",
+  "build",
+  "twine",
+]
+
+# -------------------------------------------------------------------------
+# Bundle compose files and .env.example as package data so they are
+# available after `pip install projectdavid-platform` without any git clone.
+# start_orchestration.py resolves these via importlib.resources.
+# -------------------------------------------------------------------------
+[tool.setuptools.package-data]
+"projectdavid_platform" = [
+  "docker-compose.yml",
+  "docker-compose.gpu.yml",
+  ".env.example",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["projectdavid_platform*"]
+
+[tool.black]
+line-length = 100
+target-version = ["py39"]
+
+[tool.isort]
+profile = "black"
+
+[tool.ruff]
+line-length = 100
+
+[tool.semantic_release]
+version_source = "tag"
+upload_to_pypi = false

projectdavid_platform-1.8.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+