Authentication

API Keys

All requests require an API key. Keys are prefixed with kf- and can be created from the dashboard.

import kitefishai

client = kitefishai.Client(api_key="kf-...")

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.

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.

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"