# Umbra

> Umbra is a private-prompt inference API on Apple Silicon. It serves open-weight,
> uncensored, and community GGUF models that major hosts refuse, via an OpenAI- and
> Anthropic-compatible API. Prompts are never logged; hardware attestation aims to
> prevent the machine owner from reading them. Alpha: free credit on signup.

Umbra has two audiences: developers calling the API, and Mac owners hosting models.
This file lists canonical pages for AI agents and search systems.

## For developers (call the API)

- [Homepage](https://tryumbra.dev/): Product overview, live model grid, trust bar.
- [Try free](https://tryumbra.dev/try): Stream a response with no signup or API key.
- [Model catalog](https://tryumbra.dev/console/models): Live GGUF models, pricing per million tokens.
- [API keys](https://tryumbra.dev/console/keys): Mint umbra-... keys (requires sign-in).
- [Network stats](https://tryumbra.dev/console/stats): Live coordinator and provider stats.

Base URL: `https://api.tryumbra.dev/v1` (OpenAI-compatible chat completions).
Anthropic-compatible: `POST https://api.tryumbra.dev/v1/messages`.
List models: `GET https://api.tryumbra.dev/v1/models`.
Coordinator attestation proof: `GET https://api.tryumbra.dev/v1/attestation`.

Agent self-onboard (alpha, rate-limited): `POST /v1/auth/signup` then `POST /v1/keys`
with the returned bearer token to obtain an `umbra-...` secret.

## For providers (host on your Mac, earn)

- [Provider setup guide](https://tryumbra.dev/console/setup): Install CLI, login, MDM profile, umbra host, umbra status.
- [Earn with your Mac](https://tryumbra.dev/become-a-provider): Provider onboarding overview.
- [Earnings calculator](https://tryumbra.dev/console/host): Projected earnings by model for your hardware.
- [Your devices](https://tryumbra.dev/console/provider-models): What your Macs serve (requires sign-in).

Provider flow: `curl -fsSL https://tryumbra.dev/install | sh`, `umbra login`, install
the attestation profile from `https://mdm.tryumbra.dev/mdm/enroll`, then `umbra host`.

## Trust and verification

- [How attestation works](https://tryumbra.dev/docs/attestation): Secure Enclave, MDA, register frame.
- [Threat model](https://tryumbra.dev/docs/threat-model): What Umbra does and does not guarantee.
- [Blog](https://tryumbra.dev/blog): Technical posts on privacy and attestation.
- [Full agent context](https://tryumbra.dev/llms-full.txt): Extended API and routing notes for AI agents.

## Legal

- [Privacy policy](https://tryumbra.dev/privacy): Data handling; prompts not logged.
- [Terms of service](https://tryumbra.dev/terms): Alpha terms.
- [Provider agreement](https://tryumbra.dev/provider-agreement): Hosting terms.

## Optional

- [Sign up](https://tryumbra.dev/signup): Create an account.
- [Sign in](https://tryumbra.dev/signin): Existing account login.