​
Step 1: Sign Up and Create an API Key

  1. Visit Chunkr AI
  2. Click on “Login” and create your account
  3. Once logged in, navigate to “API Keys” in the dashboard

For self-hosted deployments:

​
Step 2: Install our client SDK

pip install chunkr-ai

​
Step 3: Upload your document

from chunkr_ai import Chunkr

# Initialize the Chunkr client with your API key - get this from https://chunkr.ai
chunkr = Chunkr(api_key="your_api_key")

# Upload a document via url or local file path
url = "https://chunkr-web.s3.us-east-1.amazonaws.com/landing_page/input/science.pdf"
task = chunkr.upload(url)

​
Step 4: Clean up

You can clean up the open connections by calling the close() method on the Chunkr client.

chunkr.close()

​
Environment Setup

You can authenticate with the Chunkr AI API in two ways:

  1. Direct API Key - Pass your API key directly when initializing the client
  2. Environment Variable - Set CHUNKR_API_KEY in your .env file

You can also configure the API endpoint:

  1. Direct URL - Pass your API URL when initializing the client
  2. Environment Variable - Set CHUNKR_URL in your .env file

This is particularly useful if you’re running a self-hosted version of Chunkr.

from chunkr_ai import Chunkr

# Option 1: Initialize with API key directly
chunkr = Chunkr(api_key="your_api_key")

# Option 2: Initialize without api_key parameter - will use CHUNKR_API_KEY from environment
chunkr = Chunkr()

# Option 3: Configure custom API endpoint
chunkr = Chunkr(api_key="your_api_key", chunkr_url="http://localhost:8000")

# Option 4: Use environment variables for both API key and URL
chunkr = Chunkr()  # will use CHUNKR_API_KEY and CHUNKR_URL from environment
Usage