Skip to main content
The kovi-sdk Python package gives you programmatic access to the Kovi interview platform. Install it from PyPI and initialize it with your API key to start scheduling interviews from your code.
kovi-sdk requires Python 3.8 or higher.

​
Requirements

Before you install the SDK, make sure you have the following:
  • Python 3.8 or higher installed on your system. Run python --version to check.
  • A Techeval account with an active API key. Sign up at techeval.ai — new accounts receive 10 free credits on sign-up.

​
Install with pip

Run the following command to install kovi-sdk from PyPI:
We recommend working inside a virtual environment to keep your project dependencies isolated:
1

Create a virtual environment

2

Activate the virtual environment

3

Install the SDK

​
Initialize the Client

Import KoviClient and pass your API key to create a client instance:
client_init.py
Never hardcode your API key in source code. Use environment variables or a secrets manager instead — see the section below.
Store your API key in an environment variable and read it at runtime to keep credentials out of your codebase:
client_env.py
Set the environment variable in your shell before running your script:
For persistent configuration, add the export line to your ~/.bashrc, ~/.zshrc, or equivalent shell profile file. In production, inject the variable through your deployment platform’s secrets manager (e.g., AWS Secrets Manager, GCP Secret Manager, or a CI/CD environment variable store).

​
Verify Your Setup

Instantiate the client to confirm the SDK is installed and your import paths are correct. No network call is made at construction time, so this step does not consume any credits:
verify_setup.py
Calling client.schedule_interview(...) initiates a live interview session and consumes one credit when the interview starts. Run verification using only the constructor until you are ready to schedule a real interview.
Once your client initializes without errors, you are ready to schedule your first interview. See the KoviClient Reference for the full API, or jump straight to the Examples to copy a working integration.