Metadata-Version: 2.3
Name: agent-core-toolkit
Version: 0.1.4
Summary: Common building blocks for creating AI agents.
Author: David Koleczek
Author-email: David Koleczek <45405824+DavidKoleczek@users.noreply.github.com>
Requires-Dist: click>=8.3,<9.0
Requires-Dist: httpx>=0.28,<1.0
Requires-Dist: interop-router>=0.1.8,<0.2
Requires-Dist: loguru>=0.7,<1.0
Requires-Dist: pydantic>=2.12,<3.0
Requires-Dist: pymupdf>=1.27,<2.0
Requires-Dist: pymupdf4llm>=0.3,<1.0
Requires-Dist: python-liquid>=2.1,<3.0
Requires-Dist: rich>=14.3,<15.0
Requires-Dist: tree-sitter>=0.25,<1.0
Requires-Dist: tree-sitter-bash>=0.25,<1.0
Requires-Dist: crawl4ai[pdf]>=0.8,<1.0 ; extra == 'web'
Requires-Dist: feedparser>=6.0,<7.0 ; extra == 'web'
Requires-Dist: markitdown==0.1.5 ; extra == 'web'
Requires-Python: >=3.11
Provides-Extra: web
Description-Content-Type: text/markdown

    agent-core

Common building blocks for creating AI agents.

Production-ready components for building AI agents, optimized across LLMs and providers. Uses [InteropRouter](https://github.com/DavidKoleczek/interop-router) as a unified AI model provider interface.

> [!NOTE]
> This library is in early development and subject to change.

## Getting Started

### Installation

```bash
# With uv.
uv add agent-core-toolkit

# With pip.
pip install agent-core-toolkit
```

### Optional Dependencies

For the web fetch tool:

```bash
uv add agent-core-toolkit[web]

# Run crawl4ai post-installation setup
crawl4ai-setup
```


## Usage

Run the agent CLI.

```bash
uv run agent-core --prompt "Your prompt here" --working-dir /path/to/directory
```

With all options:

```bash
uv run agent-core --prompt "Your prompt here" --working-dir "/path/to/directory" --mode "permissive" --model "gpt-5.1-codex-max" --model-friendly-name "gpt-5.1-codex-max" --model-knowledge-cutoff "Sep 30, 2024" --timezone "America/New_York"
```

Or run with uvx:

```bash
uvx --from /path/to/agent-core agent-core --prompt "Your prompt here" --working-dir "/path/to/directory"
```


## Development

### Prerequisites

- [uv](https://docs.astral.sh/uv/getting-started/installation/)
- [prek](https://github.com/j178/prek/blob/master/README.md#installation)

### Setup

Create uv virtual environment and install dependencies:

```bash
uv sync --frozen --all-extras --all-groups
```

Set up git hooks:

```bash
prek install
```

To update dependencies (updates the lock file):

```bash
uv sync --all-extras --all-groups
```

Run formatting, linting, type checking, and tests in one command:

```bash
uv run ruff format && uv run ruff check --fix && uv run ty check && uv run pytest
```

### Further Information

[docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)