API Keys
All requests require an API key. Keys are prefixed with kf- and can be created from the dashboard.
Option 1 — Pass directly
import kitefishai
client = kitefishai.Client(api_key="kf-...")
Option 2 — Environment variable (recommended)
Set KITEFISH_API_KEY in your environment and the client picks it up automatically:
export KITEFISH_API_KEY="kf-..."
client = kitefishai.Client()
This is the recommended approach. It keeps credentials out of source code.
Option 3 — .env file
Use a library like python-dotenv:
# .env
KITEFISH_API_KEY=kf-...
from dotenv import load_dotenv
load_dotenv()
import kitefishai
client = kitefishai.Client()
Never commit API keys to source control. Add .env to your .gitignore.
On-prem deployments
For air-gapped enterprise deployments, override the base URL:
client = kitefishai.Client(
api_key="kf-...",
base_url="https://your-internal-host/v1",
)
Or via environment:
export KITEFISH_BASE_URL="https://your-internal-host/v1"