Registry / llm-agents / pydantic-ai-todo

pydantic-ai-todo

library0.2.6pypypi✓ verified 88d ago

Todo/task planning toolset for pydantic-ai agents. Provides a FunctionToolset and a TodoCapability (agent capability) for todo list management including create, read, update, delete, subtasks, and dependency tracking. Supports both sync and async storage backends. Current version 0.2.1, requires Python >=3.10, active development with frequent releases.

llm-agents ai-ml database serialization

pip install pydantic-ai-todo

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · PYDANTIC-AI-TODO

pydantic-ai-todo

llm-agentspythonv0.2.6

Install

5.3s avg

Import

2254ms

Disk

50MB

Pass rate

8/ 10

Env Coverage8 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.2.6 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✓ —

✓ 6s

py 3.11

✓ —

✓ 5.4s

py 3.12

✓ —

✓ 4.8s

py 3.13

✓ —

✓ 4.8s

py 3.9

✕ build_error

50MB installed

● package 50MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TodoCapability

✓ from pydantic_ai_todo import TodoCapability

✗ from pydantic_ai_todo.capabilities import TodoCapability

TodoCapability is top-level exported since v0.2.0

create_todo_toolset

✓ from pydantic_ai_todo import create_todo_toolset

✗ from pydantic_ai_todo.toolset import create_todo_toolset

Direct top-level export since v0.1.0

MemoryStorage

✓ from pydantic_ai_todo import MemoryStorage

Top-level export for sync in-memory storage

AsyncMemoryStorage

✓ from pydantic_ai_todo import AsyncMemoryStorage

Top-level export for async in-memory storage

TodoStorageProtocol

✓ from pydantic_ai_todo import TodoStorageProtocol

Sync storage protocol, top-level export

Create an agent with todo capability using in-memory storage. Requires OPENAI_API_KEY in environment.

import os from pydantic_ai import Agent from pydantic_ai_todo import TodoCapability, MemoryStorage storage = MemoryStorage() agent = Agent("openai:gpt-4o", capabilities=[TodoCapability(storage=storage)]) result = agent.run_sync("Add a task to buy milk") print(result.data)

Debug

Known issues

breakingIn v0.2.0, the recommended API changed from create_todo_toolset to TodoCapability. The toolset approach still works but may not receive future updates.

fix

Migrate to TodoCapability: replace create_todo_toolset(storage) with TodoCapability(storage) and pass agent via capabilities=[...].

affects: <0.2.0

breakingv0.2.1 requires pydantic-ai-slim >=1.74.0 for async get_instructions. Older versions will fail to load the toolset if installed with a lower version.

fix

Upgrade pydantic-ai-slim to >=1.74.0: pip install "pydantic-ai-slim>=1.74.0"

affects: <0.2.1

deprecatedThe CLI (command-line entry point) was removed in v0.1.6. The package is library-only.

fix

Use the Python API directly; no CLI available.

affects: >=0.1.6

gotchaTodo IDs are auto-generated 8-char hex strings. When using update_todo_status or remove_todo, you must provide the exact ID. The system prompt includes ID in format [abc123ef] since v0.1.8.

fix

Ensure agent can see todo IDs in system prompt. If using custom prompts, include IDs explicitly.

affects: >=0.1.3

Errors

Common errors & fixes

ImportError: cannot import name 'create_todo_toolset' from 'pydantic_ai_todo'

Package version too old (pre-0.1.0) or misspelled function name.

fix

Upgrade: pip install --upgrade pydantic-ai-todo

AttributeError: 'Agent' object has no attribute 'capabilities'

Using an older version of pydantic-ai that doesn't support capabilities (requires pydantic-ai >=0.0.18).

fix

Upgrade pydantic-ai-slim: pip install "pydantic-ai-slim>=1.74.0"

TypeError: TodoCapability.__init__() missing 1 required positional argument: 'storage'

Storage parameter is mandatory; omitted when instantiating TodoCapability.

fix

Provide a storage instance: TodoCapability(storage=MemoryStorage())

Upgrade

Version history

0.2.6latest on PyPI · released Jun 17, 2026

Audit

Dependencies

pydantic-ai-slimrequiredCore dependency for agent and toolset functionality (>=1.74.0)

Agent activity

24 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/vstorm-co/pydantic-ai-todo ↗

packagehttps://pypi.org/project/pydantic-ai-todo/ ↗

docshttps://github.com/vstorm-co/pydantic-ai-todo#readme ↗

changeloghttps://github.com/vstorm-co/pydantic-ai-todo/releases ↗