An open API service indexing awesome lists of open source software.

https://github.com/tracebloc/client

Deployable tracebloc client for running model training pipelines
https://github.com/tracebloc/client

aks-cluster client eks-cluster kubernetes mlops tracebloc

Last synced: about 1 month ago
JSON representation

Deployable tracebloc client for running model training pipelines

Awesome Lists containing this project

README

          

[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE) [![Docker](https://img.shields.io/badge/docker-tracebloc%2Fclient-2496ED.svg)](https://hub.docker.com/r/tracebloc/client) [![Platform](https://img.shields.io/badge/platform-tracebloc-00C9A7.svg)](https://ai.tracebloc.io)

# tracebloc Client ๐Ÿ”’

The runtime that keeps your data where it belongs โ€” on your infrastructure.

The tracebloc client deploys inside your Kubernetes cluster and executes all model training, fine-tuning, and inference locally. It connects to the tracebloc backend for orchestration only. No data, no model weights, no artifacts ever leave your environment.

## Architecture

```
Your infrastructure
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ โ”‚
โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
โ”‚ โ”‚ tracebloc โ”‚ โ”‚ Kubernetes cluster โ”‚ โ”‚
โ”‚ โ”‚ client โ”‚โ—„โ”€โ”€โ”€โ”€โ–บโ”‚ โ”‚ โ”‚
โ”‚ โ”‚ โ”‚ โ”‚ โ— Training jobs โ”‚ โ”‚
โ”‚ โ”‚ Orchestrates โ”‚ โ”‚ โ— Inference jobs โ”‚ โ”‚
โ”‚ โ”‚ training, โ”‚ โ”‚ โ— Your datasets โ”‚ โ”‚
โ”‚ โ”‚ enforces budgets โ”‚ โ”‚ โ— Fine-tuned weights โ”‚ โ”‚
โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚
โ”‚ โ”‚ โ”‚ Everything stays here โ”‚ โ”‚
โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
โ”‚
โ”‚ Encrypted (orchestration only โ€” no data)
โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ tracebloc โ”‚
โ”‚ backend โ”‚
โ”‚ โ”‚
โ”‚ Coordinates โ”‚
โ”‚ experiments, โ”‚
โ”‚ serves web UI โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
```

## What the client manages

- **Training execution** โ€” runs vendor models in isolated, containerized sandboxes
- **Compute budgets** โ€” enforces per-vendor FLOPs or runtime quotas
- **Security boundaries** โ€” namespace isolation, encrypted communication, audit logging
- **Multi-framework support** โ€” PyTorch, TensorFlow, custom containers
- **Hardware scheduling** โ€” CPUs, GPUs, TPUs via Kubernetes-native orchestration

## Security

For the threat model, defense layers, per-platform caveats, operator responsibilities, and verification steps, see **[docs/SECURITY.md](docs/SECURITY.md)**. The chart ships hardened defaults against untrusted user-submitted ML code; deployment still requires a CNI that enforces NetworkPolicy โ€” that file explains exactly what to check.

## Deploy

```bash
docker pull tracebloc/client:latest
```

Deployment varies by infrastructure. Follow the guide for your setup:

- [Deployment overview](https://docs.tracebloc.io/environment-setup/deployment-overview)
- [Local โ€” Linux](https://docs.tracebloc.io/environment-setup/local-linux)
- [Local โ€” macOS](https://docs.tracebloc.io/environment-setup/local-macos)
- [AWS](https://docs.tracebloc.io/environment-setup/aws)

Full documentation โ†’ [docs.tracebloc.io](https://docs.tracebloc.io/)

## Links

[Platform](https://ai.tracebloc.io/) ยท [Docs](https://docs.tracebloc.io/) ยท [Discord](https://discord.gg/tracebloc)

## License

Apache 2.0 โ€” see [LICENSE](LICENSE).

**Deployment help?** [support@tracebloc.io](mailto:support@tracebloc.io) or [open an issue](https://github.com/tracebloc/client/issues).