Installation

Requirements

• Python 3.10 or higher
• pip (included with Python)

Install Klisk

pip install klisk

For multi-provider support (Anthropic, Gemini, Mistral, etc.):

pip install 'klisk[litellm]'

Initialize the workspace

Run klisk for the first time to create the directory structure:

klisk

This creates:

~/klisk/
└── projects/        # Your agents will live here

Configure the API key

Each project has its own .env file. When you create a project with klisk create, it's generated automatically:

klisk create my-agent

Edit the project's .env file:

# ~/klisk/projects/my-agent/.env

# OpenAI (default)
OPENAI_API_KEY=sk-...

# Or for other providers:
# ANTHROPIC_API_KEY=sk-ant-...
# GEMINI_API_KEY=...
# MISTRAL_API_KEY=...

Verify the installation

klisk list

If you see the project list (or a message indicating there are no projects yet), Klisk is correctly installed.

Virtual environment

Each project created with klisk create includes its own virtual environment (.venv/) with Klisk pre-installed. You don't need to manage dependencies manually — the environment is automatically activated when using klisk studio, klisk run, and klisk start.