Skip to content

quickstart.md

Latest commit

 

History

History
72 lines (49 loc) · 1.16 KB

quickstart.md

File metadata and controls

72 lines (49 loc) · 1.16 KB
Raw

Quickstart

Install

python -m pip install -e .[dev]

Run Local Checks

python -m unittest discover -s tests
python -m compileall -q src tests examples

Run The Fake Provider

The fake provider needs no API key.

apg-smoke health
apg-smoke execute --model fake-text-model
apg-smoke stream --model fake-text-model

Use In Python

from agentic_provider_gateway import ModelGatewayService

gateway = ModelGatewayService.from_defaults()
print(gateway.health()["ok"])

See examples/basic_fake_request.py for a full request.

Enable Real Providers

Create a local .env:

Copy-Item .env.example .env

Fill in:

GEMINI_API_KEY=
GROQ_API_KEY=

Then run opt-in real-provider calls:

apg-smoke execute --provider gemini --model gemini-2.5-flash --allow-real-provider
apg-smoke execute --provider groq --model openai/gpt-oss-20b --allow-real-provider

Runtime State

Generated state defaults to .apg/:

.apg/gateway_traces.sqlite3
.apg/gateway_state/*.json

Override it with:

$env:APG_STORAGE_DIR="C:\path\to\gateway-state"