Skip to content

Installation

Follow the steps below to install Tzara, the Telekinesis Physical AI Agent, into Visual Studio Code.

Tzara installation walkthrough

Visual Studio Code Extension Installation

  1. Open Visual Studio Code and navigate to the Extensions view by clicking on the Extensions icon in the Activity Bar on the side of the window or by pressing Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (macOS).
  2. In the search bar, type "Tzara" by Telekinesis.
  3. Click on the "Install" button.

API Key Configuration

Tzara requires 2 API keys to function: the TELEKINESIS_API_KEY for accessing the Telekinesis SDK and the ANTHROPIC_API_KEY for accessing the underlying language models.

Set the API Keys

Select the tab matching your shell and run the commands to set both keys. On macOS / Linux, you can run echo $SHELL to check which shell you're using.

powershell
# Persist for future sessions
setx ANTHROPIC_API_KEY "<your_key>"
setx TELEKINESIS_API_KEY "<your_key>"

# Also set for the current session
$env:ANTHROPIC_API_KEY="<your_key>"
$env:TELEKINESIS_API_KEY="<your_key>"
bash
echo 'export ANTHROPIC_API_KEY="<your_key>"' >> ~/.bashrc && echo 'export TELEKINESIS_API_KEY="<your_key>"' >> ~/.bashrc && source ~/.bashrc
zsh
echo 'export ANTHROPIC_API_KEY="<your_key>"' >> ~/.zshrc && echo 'export TELEKINESIS_API_KEY="<your_key>"' >> ~/.zshrc && source ~/.zshrc
fish
echo 'set -gx ANTHROPIC_API_KEY "<your_key>"' >> ~/.config/fish/config.fish && echo 'set -gx TELEKINESIS_API_KEY "<your_key>"' >> ~/.config/fish/config.fish && source ~/.config/fish/config.fish

INFO

On Windows, setx updates future PowerShell sessions. If you open a new terminal, the keys will already be available.

Verify the API Keys

Print the values of both keys to confirm they are set:

powershell
echo $env:ANTHROPIC_API_KEY
echo $env:TELEKINESIS_API_KEY
bash
echo $ANTHROPIC_API_KEY
echo $TELEKINESIS_API_KEY

You should see the values of both keys printed in the terminal.

Key not found?

If the key is not found or appears empty, your terminal session has not picked up the new environment variables yet. Close all VS Code windows, restart VS Code, and open a fresh terminal — the updated environment will then be loaded.

Run Tzara in Visual Studio Code

To test that Tzara is installed and configured correctly:

  1. Open Visual Studio Code
  2. Open the Command Palette by pressing Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS).
  3. Type: Tzara
  4. Select Tzara: Open Chat. This will open a new chat interface where you can interact with Tzara.
  5. Try typing a simple instruction like Hi Tzara! and see if you receive a response. If you do, then Tzara is successfully installed and ready to use!

TIP

Tzara is always available on the top right corner of Visual Studio Code. You can click on the Telekinesis icon to open the chat interface at any time.

Uninstallation

To uninstall the Tzara Visual Studio Code extension, follow these steps:

  1. Open Visual Studio Code and navigate to the Extensions view by clicking on the Extensions icon in the Activity Bar on the side of the window or by pressing Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (macOS).
  2. In the search bar, type "Tzara" by Telekinesis.
  3. Click on the "Uninstall" button.