Installation
Follow the steps below to install Tzara, the Telekinesis Physical AI Agent, into Visual Studio Code.
Visual Studio Code Extension Installation
- 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) orCmd+Shift+X(macOS). - In the search bar, type "Tzara" by Telekinesis.
- 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:
# windows (PowerShell)
setx ANTHROPIC_API_KEY "<your_key>"
setx TELEKINESIS_API_KEY "<your_key>"Also set in the current shell session:
# windows (PowerShell)
$env:ANTHROPIC_API_KEY="<your_key>"
$env:TELEKINESIS_API_KEY="<your_key>"To verify that the keys are set, run:
# Verify
echo $env:ANTHROPIC_API_KEY
echo $env:TELEKINESIS_API_KEYYou 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:
echo $SHELLThen, depending on your shell, run the appropriate command to set the environment variables for both API keys:
# 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.fishVerify the keys are set:
echo $ANTHROPIC_API_KEY
echo $TELEKINESIS_API_KEYYou 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:
- Open Visual Studio Code
- Open the Command Palette by pressing
Ctrl+Shift+P(Windows/Linux) orCmd+Shift+P(macOS). - Type:
Tzara - Select
Tzara: Open Chat. This will open a new chat interface where you can interact with Tzara. - 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:
- 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) orCmd+Shift+X(macOS). - In the search bar, type "Tzara" by Telekinesis.
- Click on the "Uninstall" button.

