Skip to content

Installation

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

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.

Windows (PowerShell) API Key Configuration

Set the environment variables for both API keys:

bash
# windows (PowerShell)
setx ANTHROPIC_API_KEY "<your_key>"
setx TELEKINESIS_API_KEY "<your_key>"

Also set in the current shell session:

bash
# windows (PowerShell)
$env:ANTHROPIC_API_KEY="<your_key>"
$env:TELEKINESIS_API_KEY="<your_key>"

To verify that the keys are set, run:

bash
# Verify
echo $env:ANTHROPIC_API_KEY
echo $env:TELEKINESIS_API_KEY

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

INFO

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

macOS / Linux API Key Configuration

First, determine your shell type:

bash
echo $SHELL

Then, depending on your shell, run the appropriate command to set the environment variables for both API keys:

bash
# bash
echo 'export ANTHROPIC_API_KEY="<your_key>"' >> ~/.bashrc && echo 'export TELEKINESIS_API_KEY="<your_key>"' >> ~/.bashrc && source ~/.bashrc
zsh
# zsh
echo 'export ANTHROPIC_API_KEY="<your_key>"' >> ~/.zshrc && echo 'export TELEKINESIS_API_KEY="<your_key>"' >> ~/.zshrc && source ~/.zshrc
fish
# 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

Verify the keys are set:

bash
echo $ANTHROPIC_API_KEY
echo $TELEKINESIS_API_KEY

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

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.