Quickstart

Create your first agent, connect a tool and run it — in about five minutes.

1. Install the SDK

Install the official package for your language:

pip install vektra

npm install @vektra/sdk

go get github.com/vektra/vektra-go

2. Authenticate

Create a key in Settings → API keys and export it as an environment variable. Never commit keys to source control.

export VEKTRA_KEY="vk_live_..."

3. Create an agent

An agent combines instructions, a list of tools and optional approval rules:

from vektra import Vektra

client = Vektra(api_key="vk_live_...")

# Create an agent with tools and guardrails
agent = client.agents.create(
    name="Nova",
    instructions="Resolve billing tickets politely.",
    tools=["helpbase", "ledgerly"],
    approval={"refund": "over_100"},
)

run = agent.run(input="Where is my invoice for March?")
print(run.output)

import Vektra from "@vektra/sdk";

const vektra = new Vektra({ apiKey: process.env.VEKTRA_KEY });

// Create an agent with tools and guardrails
const agent = await vektra.agents.create({
  name: "Nova",
  instructions: "Resolve billing tickets politely.",
  tools: ["helpbase", "ledgerly"],
});

const run = await agent.run({ input: "Where is my invoice?" });
console.log(run.output);

4. Run your agent

Runs are asynchronous by default. Pass stream=True to receive each step as it happens, or register a webhook to be notified when the run completes.

Next steps