agentize
Agentize provides out-of-the-box tools for building chatbot agent with LLMs.
Usage
Installation
pip install agentize
# If you want to use langfuse
pip install agentize[langfuse]
# If you want to use markitdown
pip install agentize[markitdown]
# Or just install all the extras
pip install agentize[all]
Tools
MarkItDown
markitdown_scrapetool to scrape a URL and get its content.
Firecrawl
firecrawl_scrapetool to scrape a URL and get its content.searchtool to perform web searches and optionally retrieve content from the results.maptool to go from a single url to a map of the entire website.
Telegraph
publish_page_mdtool to publish a markdown document to telegraph and get its URL.
Wise
query_rate_historytool to query the rate history of a currency.
Agents
- Summary agent to summarize a document.
Examples
Chatbot agent. Summarize chatbot. The -w flag tells Chainlit to enable auto-reloading, so you don’t need to restart the server every time you make changes to your application.
uv run chainlit run examples/chatbot_agent.py -w
Chatbot with MCP client.
uv run chainlit run examples/mcp_chatbot.py -w
Summarize chatbot.
uv run chainlit run examples/summarize_chatbot.py -w
Prompt generation:
uv run chainlit run examples/prompt_generation.py -w
Development
type check and format the code
make format fix type
pre-commit git hook installation
pre-commit install
# or manually run
pre-commit run --all-files
Environment variables
# OpenAI compatible API
# export OPENAI_BASE_URL="..."
# export OPENAI_API_KEY="..."
# OpenAI
# export OPENAI_MODEL="gpt-4o-mini"
# export OPENAI_API_KEY="sk-..."
# Firecrawl (optional)
export FIRECRAWL_API_KEY="fc-..."
# Object Storage (optional), S3 compatible Storage
export AWS_ACCESS_KEY_ID="..."
export AWS_SECRET_ACCESS_KEY=".."
export AWS_ENDPOINT_URL_S3="..."
export AWS_BUCKET_NAME="..."
# Langfuse
export LANGFUSE_PUBLIC_KEY="pk-..."
export LANGFUSE_SECRET_KEY="sk-..."
export LANGFUSE_HOST="..."
# Azure OpenAI
export AZURE_OPENAI_API_KEY="..."
export AZURE_OPENAI_ENDPOINT="..."
export OPENAI_MODEL="gpt-4.1"
# see https://learn.microsoft.com/azure/ai-services/openai/api-version-deprecation for more details
export OPENAI_API_VERSION="2025-03-01-preview"
We follow the same environment variable conventions used by the official OpenAI and Azure OpenAI SDKs. This ensures a seamless integration experience and consistency across environments. The only difference is that if the environment variable AZURE_OPENAI_API_KEY is present, AzureOpenAI will be used. Below is a list of supported environment variables for each client, along with their descriptions and usage examples.
OpenAI / AsyncOpenAI
| Variable Name | Description |
|---|---|
OPENAI_API_KEY |
✅ Required. Your OpenAI API key |
OPENAI_ORG_ID |
🟡 Optional. Organization ID |
OPENAI_PROJECT_ID |
🟡 Optional. Project ID |
OPENAI_BASE_URL |
🟡 Optional. Custom base URL (e.g., for proxy usage) |
AzureOpenAI / AsyncAzureOpenAI
| Variable Name | Description |
|---|---|
AZURE_OPENAI_API_KEY |
✅ Required if not using AD token. Azure OpenAI API key |
AZURE_OPENAI_AD_TOKEN |
✅ Required if not using API key. Azure Active Directory token |
OPENAI_API_VERSION |
✅ Required. API version, e.g., 2025-03-01-preview |
AZURE_OPENAI_ENDPOINT |
✅ Required. Azure endpoint (e.g., https://your-resource.openai.azure.com) |
OPENAI_ORG_ID |
🟡 Optional. Organization ID (for compatibility) |
OPENAI_PROJECT_ID |
🟡 Optional. Project ID (for compatibility) |
Metadata
Release files for agentize 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agentize-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for agentize-0.1.0-py3-none-any.whl |
Release files / agentize-0.1.0-py3-none-any.whl
| Download URL | agentize-0.1.0-py3-none-any.whl |
|---|---|
| Size | 19.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4ae89979c50fc045f711534d19e7cd6f0f3a63202f5b4a720e19140373d4aea8
|
|
BLAKE2b-256 checksum How to use checksums |
50113329691488ad397ff4b17d7adc260f05b4295a9baff9d4e1e9095609ac37
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.8
|
Security for agentize 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.