telekinesis-deployment 0.0.1__tar.gz

telekinesis_deployment-0.0.1/LICENSE.txt

@@ -0,0 +1,6 @@
+Copyright (c) Telekinesis
+
+All rights reserved.
+
+This software is proprietary and confidential.
+Unauthorized copying, distribution, or use is prohibited.

telekinesis_deployment-0.0.1/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: telekinesis-deployment
+Version: 0.0.1
+Summary: Installer and CLI for the Telekinesis deployment stack.
+Requires-Python: <3.13,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: docker==7.1.0
+Requires-Dist: loguru==0.7.3
+Requires-Dist: requests==2.33.1
+Dynamic: license-file
+
+<div align="center">
+  <p>
+    <a href="https://telekinesis.ai" target="_blank">
+      <img
+        width="100%"
+        src="https://assets.telekinesis.ai/logo/telekinesis-banner.png"
+        alt="Telekinesis"
+      >
+    </a>
+  </p>
+
+  <br>
+
+  [![Python versions](https://img.shields.io/badge/python-3.11%20%7C%203.12-blue)](https://www.python.org/)
+  [![License](https://img.shields.io/badge/license-proprietary-lightgrey)](LICENSE.txt)
+</div>
+
+<p align="center">
+  <a href="https://github.com/telekinesis-ai">GitHub</a>
+  &nbsp;&bull;&nbsp;
+  <a href="https://www.linkedin.com/company/telekinesis-ai/">LinkedIn</a>
+  &nbsp;&bull;&nbsp;
+  <a href="https://x.com/telekinesis_ai">X</a>
+  &nbsp;&bull;&nbsp;
+  <a href="https://discord.gg/7NnQ3bQHqm">Discord</a>
+</p>
+
+# Telekinesis Deployment
+
+Telekinesis Deployment provides the installation tooling and backend delivery
+workflows for the Telekinesis platform.
+
+It includes:
+
+- Cloud deployment to Amazon EKS using Helm
+- Local, single-node, and evaluator deployment using Docker Compose
+- A command-line interface for installing and managing Telekinesis services
+- Shared configuration, health checks, licensing, and provisioning utilities
+
+## Release Model
+
+Telekinesis Deployment is currently in active development (pre-1.0). Features
+and interfaces may evolve between minor releases. Use the version specified by
+the Telekinesis development team for production deployments.
+
+## Installation
+
+1. Install [Miniconda](https://docs.conda.io/projects/miniconda/en/latest/) or
+   another Python environment manager.
+
+2. Clone this repository:
+
+   ```bash
+   git clone -b develop https://gitlab.com/telekinesis/deployment.git
+   cd deployment
+   ```
+
+3. Create and activate a supported Python environment:
+
+   > Telekinesis Deployment supports Python 3.11 and 3.12.
+
+   ```bash
+   conda create -n telekinesis-deployment python=3.11
+   conda activate telekinesis-deployment
+   ```
+
+4. Install the CLI and its dependencies in editable mode:
+
+   ```bash
+   pip install -e .
+   ```
+
+5. Verify the installation:
+
+   ```bash
+   telekinesis server --help
+   ```
+
+## Example
+
+Initialize a local deployment and start its services:
+
+```bash
+telekinesis server init
+telekinesis server install
+telekinesis server status
+```
+
+Use `telekinesis server init --profile developer` to initialize a developer
+environment. Run `telekinesis server --help` to see all available commands.
+
+## Deployment Modes
+
+| Mode | When to use |
+| --- | --- |
+| [Cloud deployment](docs/helm/overview.md) | Deploy backend services to Amazon EKS with Helm |
+| [Compose deployment](docs/compose/overview.md) | Run the backend locally, on a single server, or for evaluator installations |
+
+## Resources
+
+- [Development guide](DEVELOPMENT.md)
+- [Installer documentation](docs/installer/overview.md)
+- [Telekinesis documentation](https://docs.telekinesis.ai)
+- [Release history](RELEASE.md)
+
+## Support
+
+For issues and questions, contact the Telekinesis development team at
+[support@telekinesis.ai](mailto:support@telekinesis.ai) or join the
+[Telekinesis Discord](https://discord.com/invite/7NnQ3bQHqm).
+
+## License
+
+This repository is proprietary and confidential. See [LICENSE.txt](LICENSE.txt)
+for details.

telekinesis_deployment-0.0.1/README.md

@@ -0,0 +1,115 @@
+<div align="center">
+  <p>
+    <a href="https://telekinesis.ai" target="_blank">
+      <img
+        width="100%"
+        src="https://assets.telekinesis.ai/logo/telekinesis-banner.png"
+        alt="Telekinesis"
+      >
+    </a>
+  </p>
+
+  <br>
+
+  [![Python versions](https://img.shields.io/badge/python-3.11%20%7C%203.12-blue)](https://www.python.org/)
+  [![License](https://img.shields.io/badge/license-proprietary-lightgrey)](LICENSE.txt)
+</div>
+
+<p align="center">
+  <a href="https://github.com/telekinesis-ai">GitHub</a>
+  &nbsp;&bull;&nbsp;
+  <a href="https://www.linkedin.com/company/telekinesis-ai/">LinkedIn</a>
+  &nbsp;&bull;&nbsp;
+  <a href="https://x.com/telekinesis_ai">X</a>
+  &nbsp;&bull;&nbsp;
+  <a href="https://discord.gg/7NnQ3bQHqm">Discord</a>
+</p>
+
+# Telekinesis Deployment
+
+Telekinesis Deployment provides the installation tooling and backend delivery
+workflows for the Telekinesis platform.
+
+It includes:
+
+- Cloud deployment to Amazon EKS using Helm
+- Local, single-node, and evaluator deployment using Docker Compose
+- A command-line interface for installing and managing Telekinesis services
+- Shared configuration, health checks, licensing, and provisioning utilities
+
+## Release Model
+
+Telekinesis Deployment is currently in active development (pre-1.0). Features
+and interfaces may evolve between minor releases. Use the version specified by
+the Telekinesis development team for production deployments.
+
+## Installation
+
+1. Install [Miniconda](https://docs.conda.io/projects/miniconda/en/latest/) or
+   another Python environment manager.
+
+2. Clone this repository:
+
+   ```bash
+   git clone -b develop https://gitlab.com/telekinesis/deployment.git
+   cd deployment
+   ```
+
+3. Create and activate a supported Python environment:
+
+   > Telekinesis Deployment supports Python 3.11 and 3.12.
+
+   ```bash
+   conda create -n telekinesis-deployment python=3.11
+   conda activate telekinesis-deployment
+   ```
+
+4. Install the CLI and its dependencies in editable mode:
+
+   ```bash
+   pip install -e .
+   ```
+
+5. Verify the installation:
+
+   ```bash
+   telekinesis server --help
+   ```
+
+## Example
+
+Initialize a local deployment and start its services:
+
+```bash
+telekinesis server init
+telekinesis server install
+telekinesis server status
+```
+
+Use `telekinesis server init --profile developer` to initialize a developer
+environment. Run `telekinesis server --help` to see all available commands.
+
+## Deployment Modes
+
+| Mode | When to use |
+| --- | --- |
+| [Cloud deployment](docs/helm/overview.md) | Deploy backend services to Amazon EKS with Helm |
+| [Compose deployment](docs/compose/overview.md) | Run the backend locally, on a single server, or for evaluator installations |
+
+## Resources
+
+- [Development guide](DEVELOPMENT.md)
+- [Installer documentation](docs/installer/overview.md)
+- [Telekinesis documentation](https://docs.telekinesis.ai)
+- [Release history](RELEASE.md)
+
+## Support
+
+For issues and questions, contact the Telekinesis development team at
+[support@telekinesis.ai](mailto:support@telekinesis.ai) or join the
+[Telekinesis Discord](https://discord.com/invite/7NnQ3bQHqm).
+
+## License
+
+This repository is proprietary and confidential. See [LICENSE.txt](LICENSE.txt)
+for details.

telekinesis_deployment-0.0.1/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "telekinesis-deployment"
+version = "0.0.1"
+description = "Installer and CLI for the Telekinesis deployment stack."
+readme = "README.md"
+requires-python = ">=3.11, <3.13"
+dependencies = [
+  "docker==7.1.0",
+  "loguru==0.7.3",
+  "requests==2.33.1",
+]
+
+[project.scripts]
+telekinesis = "telekinesis_deployment.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+telekinesis_deployment = [
+  "assets/compose/compose.yaml",
+  "assets/compose/.env.user.example",
+  "assets/compose/.env.developer.example",
+]

telekinesis_deployment-0.0.1/setup.cfg

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

telekinesis_deployment-0.0.1/src/telekinesis_deployment/__init__.py

@@ -0,0 +1 @@
+"""Utilities and CLI entry points for Telekinesis deployment workflows."""

telekinesis_deployment-0.0.1/src/telekinesis_deployment/assets/__init__.py

@@ -0,0 +1 @@
+"""Packaged runtime assets for Telekinesis deployment."""

telekinesis_deployment-0.0.1/src/telekinesis_deployment/assets/compose/.env.developer.example

@@ -0,0 +1,55 @@
+INSTALL_PROFILE=developer
+IMAGE_REGISTRY=registry.gitlab.com/telekinesis
+
+THALAMUS_TAG=0.1.1
+RETINA_API_TAG=0.1.2
+CORNEA_API_TAG=0.2.3
+PUPIL_API_TAG=0.3.1
+VITREOUS_API_TAG=0.2.1
+TRITON_CORNEA_TAG=0.2.0
+TRITON_RETINA_INSTANCE_1_TAG=0.1.0
+TRITON_RETINA_INSTANCE_2_TAG=0.1.0
+
+# Thalamus API
+# Postgres
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=changeme
+POSTGRES_HOST=db
+POSTGRES_PORT=5432
+POSTGRES_DB=thalamus
+
+# Cognito
+COGNITO_REGION=us-east-1
+COGNITO_USER_POOL_ID=us-east-1_SXLeSuunn
+COGNITO_CLIENT_ID=6it51v8ct58lrind00val9f7of
+
+# Retina API
+RETINA_THALAMUS_URL=http://127.0.0.1:4000
+RETINA_TRITON_URL_INSTANCE_1=127.0.0.1:8011
+RETINA_TRITON_URL_INSTANCE_2=127.0.0.1:8021
+
+# Cornea API
+CORNEA_THALAMUS_URL=http://127.0.0.1:4000
+CORNEA_TRITON_URL=127.0.0.1:8001
+
+# Pupil API
+PUPIL_THALAMUS_URL=http://127.0.0.1:4000
+
+# Vitreous API
+VITREOUS_THALAMUS_URL=http://127.0.0.1:4000
+VITREOUS_TRITON_URL_INSTANCE_1=127.0.0.1:8051
+VITREOUS_TRITON_URL_INSTANCE_2=127.0.0.1:8061
+
+# Triton Cornea
+TRITON_CORNEA_MODEL_REPOSITORY=
+
+# Triton Retina Instance 1
+TRITON_RETINA_INSTANCE_1_MODEL_REPOSITORY=
+
+# Triton Retina Instance 2
+TRITON_RETINA_INSTANCE_2_MODEL_REPOSITORY=
+
+# Triton Iris
+TRITON_IRIS_MODEL_REPOSITORY=
+
+HF_TOKEN=<huggingface-token>

telekinesis_deployment-0.0.1/src/telekinesis_deployment/assets/compose/.env.user.example

@@ -0,0 +1,55 @@
+INSTALL_PROFILE=user
+IMAGE_REGISTRY=registry.gitlab.com/telekinesis
+
+THALAMUS_TAG=0.1.1
+RETINA_API_TAG=0.1.2
+CORNEA_API_TAG=0.2.3
+PUPIL_API_TAG=0.3.1
+VITREOUS_API_TAG=0.2.1
+TRITON_CORNEA_TAG=0.2.0
+TRITON_RETINA_INSTANCE_1_TAG=0.1.0
+TRITON_RETINA_INSTANCE_2_TAG=0.1.0
+
+# Thalamus API
+# Postgres
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=changeme
+POSTGRES_HOST=db
+POSTGRES_PORT=5432
+POSTGRES_DB=thalamus
+
+# Cognito
+COGNITO_REGION=us-east-1
+COGNITO_USER_POOL_ID=
+COGNITO_CLIENT_ID=
+
+# Retina API
+RETINA_THALAMUS_URL=http://127.0.0.1:4000
+RETINA_TRITON_URL_INSTANCE_1=127.0.0.1:8011
+RETINA_TRITON_URL_INSTANCE_2=127.0.0.1:8021
+
+# Cornea API
+CORNEA_THALAMUS_URL=http://127.0.0.1:4000
+CORNEA_TRITON_URL=127.0.0.1:8001
+
+# Pupil API
+PUPIL_THALAMUS_URL=http://127.0.0.1:4000
+
+# Vitreous API
+VITREOUS_THALAMUS_URL=http://127.0.0.1:4000
+VITREOUS_TRITON_URL_INSTANCE_1=127.0.0.1:8051
+VITREOUS_TRITON_URL_INSTANCE_2=127.0.0.1:8061
+
+# Triton Cornea
+TRITON_CORNEA_MODEL_REPOSITORY=
+
+# Triton Retina Instance 1
+TRITON_RETINA_INSTANCE_1_MODEL_REPOSITORY=
+
+# Triton Retina Instance 2
+TRITON_RETINA_INSTANCE_2_MODEL_REPOSITORY=
+
+# Triton Iris
+TRITON_IRIS_MODEL_REPOSITORY=
+
+HF_TOKEN=

telekinesis_deployment-0.0.1/src/telekinesis_deployment/assets/compose/__init__.py

@@ -0,0 +1 @@
+"""Packaged Docker Compose assets for Telekinesis deployment."""

telekinesis_deployment-0.0.1/src/telekinesis_deployment/assets/compose/compose.yaml

@@ -0,0 +1,221 @@
+
+name: telekinesis-backend
+
+services:
+  thalamus:
+    image: ${IMAGE_REGISTRY:-registry.gitlab.com/telekinesis}/thalamus:${THALAMUS_TAG:-latest}
+    container_name: thalamus-local
+    ports:
+      - "4000:4000"
+    restart: unless-stopped
+    environment:
+      # Postgres — POSTGRES_HOST overridden to the compose service name.
+      POSTGRES_USER: ${POSTGRES_USER}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+      POSTGRES_HOST: db
+      POSTGRES_PORT: ${POSTGRES_PORT}
+      POSTGRES_DB: ${POSTGRES_DB}
+      # Cognito
+      COGNITO_REGION: ${COGNITO_REGION}
+      COGNITO_USER_POOL_ID: ${COGNITO_USER_POOL_ID}
+      COGNITO_CLIENT_ID: ${COGNITO_CLIENT_ID}
+    depends_on:
+      - db
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    networks:
+      - telekinesis-net
+
+  db:
+    image: postgres:15
+    container_name: db-local
+    restart: unless-stopped
+    ports:
+      - "5432:5432"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+      POSTGRES_DB: ${POSTGRES_DB}
+    networks:
+      - telekinesis-net
+
+  adminer:
+    image: adminer
+    container_name: adminer-local
+    restart: unless-stopped
+    ports:
+      - "8080:8080"
+    networks:
+      - telekinesis-net
+
+
+  retina-api:
+    image: ${IMAGE_REGISTRY:-registry.gitlab.com/telekinesis}/retina:${RETINA_API_TAG:-latest}
+    container_name: retina-api-local
+    ports:
+      - "4300:4300"
+    restart: unless-stopped
+    environment:
+      # Cognito
+      COGNITO_REGION: ${COGNITO_REGION}
+      COGNITO_USER_POOL_ID: ${COGNITO_USER_POOL_ID}
+      COGNITO_CLIENT_ID: ${COGNITO_CLIENT_ID}
+      # Service URLs — overridden to use compose network names instead of 127.0.0.1.
+      RETINA_THALAMUS_URL: http://thalamus:4000
+      RETINA_TRITON_URL_INSTANCE_1: triton-retina-instance-1:8001
+      RETINA_TRITON_URL_INSTANCE_2: triton-retina-instance-2:8001
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    networks:
+      - telekinesis-net
+
+  cornea-api:
+    image: ${IMAGE_REGISTRY:-registry.gitlab.com/telekinesis}/cornea:${CORNEA_API_TAG:-latest}
+    container_name: cornea-api-local
+    ports:
+      - "4400:4400"
+    restart: unless-stopped
+    environment:
+      # Service URLs — overridden to use compose network names instead of 127.0.0.1.
+      CORNEA_THALAMUS_URL: http://thalamus:4000
+      CORNEA_TRITON_URL: triton-cornea:8001
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    networks:
+      - telekinesis-net
+
+
+  pupil-api:
+    image: ${IMAGE_REGISTRY:-registry.gitlab.com/telekinesis}/pupil:${PUPIL_API_TAG:-latest}
+    container_name: pupil-api-local
+    ports:
+      - "4200:4200"
+    restart: unless-stopped
+    environment:
+      # Service URLs — overridden to use compose network names instead of 127.0.0.1.
+      PUPIL_THALAMUS_URL: http://thalamus:4000
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    networks:
+      - telekinesis-net
+
+  vitreous-api:
+    image: ${IMAGE_REGISTRY:-registry.gitlab.com/telekinesis}/vitreous:${VITREOUS_API_TAG:-latest}
+    container_name: vitreous-api-local
+    ports:
+      - "4100:4100"
+    restart: unless-stopped
+    environment:
+      # Service URLs — overridden to use compose network names instead of 127.0.0.1.
+      VITREOUS_THALAMUS_URL: http://thalamus:4000
+      VITREOUS_TRITON_URL_INSTANCE_1: triton-vitreous-instance-1:8001
+      VITREOUS_TRITON_URL_INSTANCE_2: triton-vitreous-instance-2:8001
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    networks:
+      - telekinesis-net
+
+
+  triton-cornea:
+    image: triton-cornea:${TRITON_CORNEA_TAG:-latest}
+    container_name: triton-cornea
+    runtime: nvidia
+    environment:
+      NVIDIA_VISIBLE_DEVICES: all
+      NVIDIA_DRIVER_CAPABILITIES: compute,utility
+      HF_TOKEN: ${HF_TOKEN}
+    ports:
+      - "8000:8000"   # HTTP
+      - "8001:8001"   # gRPC
+      - "8002:8002"   # metrics
+    volumes:
+      - ${TRITON_CORNEA_MODEL_REPOSITORY:-./cornea/model_repository}:/models
+    command:
+      - --model-repository=/models
+      - --disable-auto-complete-config
+      # - --model-control-mode=poll
+      # - --repository-poll-secs=15
+    shm_size: "2gb"
+    networks:
+      - telekinesis-net
+
+  triton-retina-instance-1:
+    image: triton-retina-instance-1:${TRITON_RETINA_INSTANCE_1_TAG:-latest}
+    container_name: triton-retina-instance-1
+    runtime: nvidia
+    environment:
+      NVIDIA_VISIBLE_DEVICES: all
+      NVIDIA_DRIVER_CAPABILITIES: compute,utility
+      HF_TOKEN: ${HF_TOKEN}
+    ports:
+      - "8010:8000"   # HTTP
+      - "8011:8001"   # gRPC
+      - "8012:8002"   # metrics
+    volumes:
+      - ${TRITON_RETINA_INSTANCE_1_MODEL_REPOSITORY:-./retina-instance-1/model_repository}:/models
+    command:
+      - --model-repository=/models
+      - --disable-auto-complete-config
+      # - --model-control-mode=poll
+      # - --repository-poll-secs=15
+    shm_size: "2gb"
+    networks:
+      - telekinesis-net
+
+  triton-retina-instance-2:
+    image: triton-retina-instance-2:${TRITON_RETINA_INSTANCE_2_TAG:-latest}
+    container_name: triton-retina-instance-2
+    runtime: nvidia
+    environment:
+      NVIDIA_VISIBLE_DEVICES: all
+      NVIDIA_DRIVER_CAPABILITIES: compute,utility
+      HF_TOKEN: ${HF_TOKEN}
+    ports:
+      - "8020:8000"   # HTTP
+      - "8021:8001"   # gRPC (retina / Qwen)
+      - "8022:8002"   # metrics
+    volumes:
+      - ${TRITON_RETINA_INSTANCE_2_MODEL_REPOSITORY:-./retina-instance-2/model_repository}:/models
+    command:
+      - --model-repository=/models
+      - --disable-auto-complete-config
+      # - --model-control-mode=poll
+      # - --repository-poll-secs=15
+    shm_size: "2gb"
+    networks:
+      - telekinesis-net
+
+  triton-iris-local:
+    image: nvcr.io/nvidia/tritonserver:25.05-py3
+    container_name: triton-iris-local
+    runtime: nvidia
+    environment:
+      NVIDIA_VISIBLE_DEVICES: all
+      NVIDIA_DRIVER_CAPABILITIES: compute,utility
+    ports:
+      - "8040:8000"   # HTTP
+      - "8041:8001"   # gRPC
+      - "8042:8002"   # metrics
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    volumes:
+      - ${TRITON_IRIS_MODEL_REPOSITORY:-./iris/model_repository}:/models
+    command:
+      - tritonserver
+      - --model-repository=/models
+      - --disable-auto-complete-config
+      - --model-control-mode=poll
+      - --repository-poll-secs=30
+      - --log-verbose=1
+    shm_size: "2gb"
+    networks:
+      - telekinesis-net
+
+networks:
+  telekinesis-net:
+    name: telekinesis-net
+
+volumes:
+  pgdata: