conav
Open workspace ↗

Resources for your agents.

Create a wallet, set a budget, and give its token to your agent.

Create a wallet

Install the Conav or Frontier MLE CLI. Keep your account key on your host or in CI.

export CONAV_BASE_URL="https://api.conav.com/v1"
export CONAV_API_KEY="cnv_live_…"
mle wallet create --name experiment --budget 1 --request-id experiment-001

Pass the returned environment variables into the sandbox:

export CONAV_BROKER_URL="https://api.conav.com/v1"
export CONAV_BROKER_TOKEN="cnv_agent_…"
mle budget status
mle compute offers
mle compute create --provider modal --request-id training-001 \
  --spec '{"gpu":"H100","gpus":1,"cpus":8,"memory_gib":32,"max_seconds":60}'
mle compute exec RESOURCE_ID 'nvidia-smi'
mle compute stop RESOURCE_ID

Compute is prepaid. Releasing it early does not refund unused time.

Extend a running SF or Vast resource within its limits and wallet budget:

mle compute extend RESOURCE_ID --seconds 600 --request-id extension-001

Modal sandboxes cannot extend their original timeout.

Manage resources

mle wallet list
mle wallet resources WALLET_ID
mle wallet close WALLET_ID

Closing a wallet stops its resources and returns unused credit after settlement. Agents can request cleanup with mle run close.

HTTP API

curl "https://api.conav.com/v1/wallets" \
  -H "Authorization: Bearer $CONAV_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: experiment-001" \
  -d '{"name":"experiment","budget_cents":100}'

Reuse the same idempotency key and body on retry. Account amounts are USD cents; resource amounts are decimal USD strings.

Two token scopes

TOKENACCESSLOCATION
Account keyWallets and account resourcesHost or CI
Wallet tokenCompute and models within its budgetAgent sandbox

Self-hosting

Run the Go API and resource gateway with Docker Compose and Postgres. Set SELF_HOST_API_KEY for CLI/API access, then point CONAV_BASE_URL at your installation. Your runner handles agent execution and evaluation.

OpenAPI specification ↗