Skip to main content

​
Requirements

The Dedalus Python SDK requires Python 3.9 or higher. The SDK is compatible with:
  • Python 3.9
  • Python 3.10
  • Python 3.11
  • Python 3.12
  • Python 3.13
  • Python 3.14

​
Install with pip

The simplest way to install the Dedalus SDK is using pip: 
pip install dedalus_labs

​
Install with uv

For faster installation and better dependency resolution, you can use uv: 
uv pip install dedalus_labs

​
Install with Poetry

If you’re using Poetry for dependency management: 
poetry add dedalus_labs

​
Install with optional dependencies

The Dedalus SDK offers optional dependencies for enhanced functionality:
For improved concurrency performance with async operations:
pip install dedalus_labs[aiohttp]
This enables aiohttp as an alternative HTTP backend for the async client, which can provide better performance for highly concurrent workloads.

​
Verify installation

After installation, verify that the SDK is installed correctly: 
import dedalus_labs
print(dedalus_labs.__version__)
This should output the current version (e.g., 0.3.0).

​
Set up authentication

1

Get your API key

Obtain your API key from the Dedalus Labs dashboard.
2

Set up environment variables

We recommend using python-dotenv to manage your API key:
pip install python-dotenv
Create a .env file in your project root:
.env
DEDALUS_API_KEY="your-api-key-here"
Never commit your .env file to version control. Add it to your .gitignore file.
3

Load environment variables

Load the environment variables in your Python code:
import os
from dotenv import load_dotenv
from dedalus_labs import Dedalus

load_dotenv()

client = Dedalus(
    api_key=os.environ.get("DEDALUS_API_KEY"),
)
The api_key parameter defaults to the DEDALUS_API_KEY environment variable, so you can omit it if the environment variable is set:
client = Dedalus()  # Automatically uses DEDALUS_API_KEY

​
Platform support

The Dedalus SDK is compatible with:
  • Operating Systems: Linux, macOS, Windows
  • Architectures: x86_64, ARM64
  • Environments: Standard Python, virtual environments, Docker containers

​
Upgrade to latest version

To upgrade to the latest version of the SDK: 
pip install --upgrade dedalus_labs

​
Dependency overview

The SDK has the following core dependencies:
  • httpx>=0.23.0, <1 - HTTP client library
  • pydantic>=1.9.0, <3 - Data validation and settings management
  • typing-extensions>=4.10, <5 - Backported type hints
  • anyio>=3.5.0, <5 - Async I/O support
  • distro>=1.7.0, <2 - OS platform information
  • sniffio - Async library detection
  • jiter>=0.10.0, <1 - Fast JSON parsing

​
Next steps

Now that you’ve installed the SDK, you’re ready to make your first API call.

Quickstart

Follow the quickstart guide to make your first API call

Build docs developers (and LLMs) love

Get started for freeTalk to us