# Packages (/docs/reference/packages)

> Every package of the repository, what it is for and its entry points.



| Package                               | Description                                                                                                                                                    | Entry points                                                                                                                                                                                                                                                                                                   |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `@better-compute/audit`               | Tamper-evident audit for better-compute: signed hourly per-tenant Merkle checkpoints over audit\_events, inclusion proofs and verification.                    | `.`                                                                                                                                                                                                                                                                                                            |
| `better-compute`                      | Manage GPU and bare-metal capacity and provision nodes in many ways: one package with every better-compute subpath.                                            | `.`, `./core`, `./protocol`, `./inventory`, `./capacity`, `./provision`, `./metal`, `./vps`, `./iam`, `./iam/plugin`, `./iam/testing`, `./events`, `./fleet`, `./rollout`, `./audit`, `./observability`, `./server`, `./gateway`, `./pki`, `./postgres`, `./pglite`, `./client`, `./cli`, `./mcp`, `./testing` |
| `@better-compute/capacity`            | Capacity for better-compute: atoms, bookings, quotas, rollups and the placement pipeline.                                                                      | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/cli`                 | The better-compute command line.                                                                                                                               | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/client`              | Typed, browser-safe client for the better-compute API.                                                                                                         | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/console-kit`         | Framework-free view models for better-compute consoles: resource stores with pagination, live event refresh and permission-aware actions.                      | `.`, `./react`                                                                                                                                                                                                                                                                                                 |
| `@better-compute/core`                | Browser-safe contracts for better-compute: domain types, errors, state tables, extension contracts and the IAM catalog.                                        | `.`, `./conformance`                                                                                                                                                                                                                                                                                           |
| `@better-compute/driver-sdk`          | bcx, the better-compute out-of-process driver protocol: serveDriver runs a defineDriver object as a plugin, externalDriver hosts one over auto-mTLS gRPC.      | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/events`              | Event delivery for better-compute: per-tenant signed webhooks with retries and dead letters, and the SSE /watch stream, read from the outbox.                  | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/fleet`               | FleetConfig as code for better-compute: export, plan and apply sites, pools, offers, quotas, flavors and provider accounts.                                    | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/gateway`             | The better-compute gateway: daemon sessions over gRPC/HTTP/2 mTLS, liveness, command dispatch and Join/Renew/Secret forwarding.                                | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/iam`                 | The better-iam bridge for better-compute: IAM plugin and catalog, event inbox, authz projection and resolver, the embedded IamPort, usage sink and flag cache. | `.`, `./plugin`, `./testing`                                                                                                                                                                                                                                                                                   |
| `@better-compute/inventory`           | Hardware inventory for better-compute: section hashing, diffs, GPU model mapping, labels and health conditions.                                                | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/mcp`                 | Model Context Protocol tools for better-compute: pools, capacity, GPU reservations and node status for AI agents, gated by better-iam.                         | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/metal`               | Bare-metal lifecycle for better-compute: power, management, boot, deploy and inspect drivers.                                                                  | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/observability`       | Metrics for better-compute: a bounded Prometheus registry, the standard better*compute*\* series, a metered IamPort and backlog gauges.                        | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/pki`                 | Machine PKI for better-compute: local CAs, SPIFFE node certificates, sealed join tokens, signed join responses and renew proofs.                               | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/postgres`            | PostgreSQL and PGlite storage for better-compute: executor, migrations and store conformance.                                                                  | `.`, `./pglite`, `./conformance`                                                                                                                                                                                                                                                                               |
| `@better-compute/protocol`            | Wire contracts between the bcd daemon and the better-compute control plane (protobuf-es generated).                                                            | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/provider-hetzner`    | Hetzner providers for better-compute: Hetzner Cloud servers as VPS instances and offers.                                                                       | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/provider-kubernetes` | Kubernetes as a capacity source for better-compute: bcd as a DaemonSet adopts a cluster's nodes and GPUs into a pool.                                          | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/provider-proxmox`    | Proxmox VE provider for better-compute: QEMU VMs cloned from templates as VPS instances.                                                                       | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/provision`           | Provisioning for better-compute: profiles, steps and the workflow engine.                                                                                      | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/rollout`             | Signed bcd releases and wave rollouts (A/B self-update) for better-compute, within each pool's disruption budget.                                              | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/server`              | The better-compute control plane: betterCompute(), the operation envelope, router and runtimes.                                                                | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/testing`             | Testing kit for better-compute: fixtures, simulated daemons, sim clock and conformance runners.                                                                | `.`                                                                                                                                                                                                                                                                                                            |
| `@better-compute/vps`                 | VPS instances for better-compute: runtimes, flavors and external providers.                                                                                    | `.`                                                                                                                                                                                                                                                                                                            |