Install the Telekinesis Agent

Tzara is the Telekinesis Physical AI Agent for VS Code. It turns natural-language instructions into robot code using your Telekinesis skills. Install it once and start building physical AI applications from your editor.

0:00 / 0:00

Tzara installation walkthrough.

Install the VS Code extension

1. Open the Extensions view (Ctrl+Shift+X on Windows/Linux, Cmd+Shift+X on macOS).
2. Search for Tzara by Telekinesis.
3. Click Install.

Generate your API keys

Key	Where to get it
TELEKINESIS_API_KEY	platform.telekinesis.ai/api-keys
ANTHROPIC_API_KEY	console.anthropic.com/settings/keys

Tzara also works with OpenAI (OPENAI_API_KEY) and Google Gemini (GOOGLE_API_KEY) models, or with local models through Ollama, which needs no key. You only need a key for the provider you use.

Set the API keys

Windows PowerShell

setx ANTHROPIC_API_KEY "<your_key>"
$env:ANTHROPIC_API_KEY="<your_key>"

# Verify
echo $env:ANTHROPIC_API_KEY

bash

echo 'export ANTHROPIC_API_KEY="<your_key>"' >> ~/.bashrc && source ~/.bashrc

# Verify
echo $ANTHROPIC_API_KEY

zsh

echo 'export ANTHROPIC_API_KEY="<your_key>"' >> ~/.zshrc && source ~/.zshrc

# Verify
echo $ANTHROPIC_API_KEY

fish

echo 'set -gx ANTHROPIC_API_KEY "<your_key>"' >> ~/.config/fish/config.fish && source ~/.config/fish/config.fish

# Verify
echo $ANTHROPIC_API_KEY

Key not printing?

Close all VS Code windows, restart VS Code, and open a fresh terminal.

Prefer not to use environment variables?

Run Tzara: Set API Key from the Command Palette, choose the provider, and paste your key. Tzara stores it in VS Code's secret storage and uses it instead of the environment variable.

Run Tzara

1. Open the folder you want Tzara to work in (File › Open Folder) and trust it when VS Code asks. Tzara saves generated code there.
2. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
3. Type Tzara and select Tzara: Open Chat.
4. Below the message box, choose a model in both the Agent and Code pickers.
5. Send a quick Hi Tzara!. A reply confirms Tzara is live.

TIP

Click the Tzara icon in the editor toolbar (top right) to reopen the chat, or the Tzara icon in the Activity Bar to browse your saved sessions. See Working with Tzara in VS Code for the full workflow.

Start prompting your robot

How the Physical AI Agent composes Skills into executable programs, with a prompting guide and worked examples.

Explore Agents →

Next Steps

Install Support for Industrial Cameras

Install optional extras for IDS, Intel RealSense, Zivid, and other vendor cameras.

Next →

Support

Join Discord

Ask questions, share what you're building, and get help from the community.

Join →

Report a bug?

Found a bug or something not working as expected? Raise an issue on our GitHub.

Raise an issue →