Metadata-Version: 2.4
Name: agentize
Version: 0.0.15
Author-email: narumi <toucans-cutouts0f@icloud.com>
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: firecrawl-py>=2.5.3
Requires-Dist: loguru>=0.7.3
Requires-Dist: markitdown>=0.1.1
Requires-Dist: openai-agents>=0.0.13
Requires-Dist: requests>=2.32.3
Requires-Dist: ua-generator>=2.0.5
Requires-Dist: wisest>=0.14.1
Requires-Dist: your-telegraph>=0.2.1
Provides-Extra: langfuse
Requires-Dist: logfire>=3.14.1; extra == 'langfuse'
Requires-Dist: nest-asyncio>=1.6.0; extra == 'langfuse'
Description-Content-Type: text/markdown

# agentize
[![image](https://img.shields.io/pypi/v/agentize.svg)](https://pypi.python.org/pypi/agentize)

Agentize provides out-of-the-box tools for building chatbot agent with LLMs.

## Usage

### Installation

```sh
pip install agentize

# If you want to use langfuse
pip install agentize[langfuse]
```

### Tools


#### MarkItDown

- `markitdown_scrape` tool to scrape a URL and get its content.

#### Firecrawl

- `firecrawl_scrape` tool to scrape a URL and get its content.
- `search` tool to perform web searches and optionally retrieve content from the results.
- `map` tool to go from a single url to a map of the entire website.

#### Telegragh

- `publish_page_md` tool to publish a markdown document to telegraph and get its URL.

#### Wise

- `query_rate_history` tool to query the rate history of a currency.

### Agents

- Summary agent to summarize a document.

## Examples

Chatbot agent

```sh
uv run chainlit run examples/chatbot_agent.py
```

Chatbot with MCP client

```sh
uv run chainlit run examples/mcp_chatbot.py
```

Summarize chatbot

```sh
uv run chainlit run examples/summarize_chatbot.py
```

## Development

type check and format the code

```sh
make format fix type
```

pre-commit git hook installation

```sh
pre-commit install
# or manually run
pre-commit run --all-files
```

### Environment variables

```sh
# OpenAI compatible proxy
# export OPENAI_PROXY_BASE_URL="..."
# export OPENAI_PROXY_API_KEY="..."

# OpenAI
# export OPENAI_MODEL="gpt-4o-mini"
# export OPENAI_API_KEY="sk-..."

# Firecrawl (optional)
export FIRECRAWL_API_KEY="fc-..."

# 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"
export OPENAI_API_VERSION="...."
```
