Skip to main content

​
Step 1: Install the SDK

pip install funky-sdk

​
Step 2: Create and export an API key

Before you begin, create an API key in the dashboard, which you’ll use to securely access the API. Store the key in a safe location, like a .zshrc file or another text file on your computer. Once you’ve generated an API key, export it as an environment variable in your terminal.

Create an API Key

export FUNKY_API_KEY="your-api-key"

​
Step 3: Spawn a sub-agent

“Bring your own key” for model providers is coming soon. For now, model usage is billed directly to your Funky account — no provider keys to configure.
Save the following as main.py:
main.py
import os
from funky import Funky

client = Funky(api_key=os.getenv("FUNKY_API_KEY"))
sub_agent = client.create_subagent(model="gemini-3-flash-preview")
try:
    messages = sub_agent.send_message("What is best restaurant in SF?")
    print(messages[-1].text)
finally:
    sub_agent.terminate()

​
Step 4: Run it

uv run main.py
Funky provisions the sub-agent, runs your message, and tears it down — no infrastructure to manage.