Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "0.5.0"
".": "0.5.1"
}
30 changes: 30 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,35 @@
# Changelog

## 0.5.1 (2025-12-20)

Full Changelog: [v0.5.0...v0.5.1](https://github.com/AgentbaseHQ/agentbase-python/compare/v0.5.0...v0.5.1)

### Bug Fixes

* compat with Python 3.14 ([506a48f](https://github.com/AgentbaseHQ/agentbase-python/commit/506a48fb364425c839e712fda2c6232a547c04a7))
* **compat:** update signatures of `model_dump` and `model_dump_json` for Pydantic v1 ([26fcf8c](https://github.com/AgentbaseHQ/agentbase-python/commit/26fcf8cfaa707947604b7f21770e375bdd8f2505))
* ensure streams are always closed ([a5fbe1f](https://github.com/AgentbaseHQ/agentbase-python/commit/a5fbe1ff1cdb9577f78959979e26cbf051349a41))
* **types:** allow pyright to infer TypedDict types within SequenceNotStr ([c8e85dc](https://github.com/AgentbaseHQ/agentbase-python/commit/c8e85dcadbd1c87e7eb467da4d5907d4be5ba067))
* use async_to_httpx_files in patch method ([15b8a78](https://github.com/AgentbaseHQ/agentbase-python/commit/15b8a78b1702ab6b3b5f81e5ffd7620f35b4666a))


### Chores

* add missing docstrings ([7f81914](https://github.com/AgentbaseHQ/agentbase-python/commit/7f81914d3ad703d6e516c4207af8be9b29639e62))
* add Python 3.14 classifier and testing ([e277845](https://github.com/AgentbaseHQ/agentbase-python/commit/e277845b95c046a36a261d5e541c3b834b9e6060))
* **deps:** mypy 1.18.1 has a regression, pin to 1.17 ([62a2800](https://github.com/AgentbaseHQ/agentbase-python/commit/62a2800278f735e3a60478f2f5bf073247f26df4))
* **docs:** use environment variables for authentication in code snippets ([6153b3a](https://github.com/AgentbaseHQ/agentbase-python/commit/6153b3ade4267a47d7e5c9f04f7df087736f14a9))
* **internal:** add `--fix` argument to lint script ([40a5771](https://github.com/AgentbaseHQ/agentbase-python/commit/40a57716ebac55d0f9474861c4a2fc6e4c30531e))
* **internal:** add missing files argument to base client ([fa1bf74](https://github.com/AgentbaseHQ/agentbase-python/commit/fa1bf74ee8af58a559cded1f9b3bdeab2bc9353b))
* **package:** drop Python 3.8 support ([27398f4](https://github.com/AgentbaseHQ/agentbase-python/commit/27398f431d61623cf51afd80eb96fa29a8d0bb17))
* speedup initial import ([ae80104](https://github.com/AgentbaseHQ/agentbase-python/commit/ae801043676a3027715757600d99416925b8e32f))
* update lockfile ([c45d94f](https://github.com/AgentbaseHQ/agentbase-python/commit/c45d94f06694f09c807bff2c994a9207b2e5568e))


### Documentation

* add more examples ([07cd970](https://github.com/AgentbaseHQ/agentbase-python/commit/07cd9702f78069d1480235504de363aa26008bd8))

## 0.5.0 (2025-11-06)

Full Changelog: [v0.4.0...v0.5.0](https://github.com/AgentbaseHQ/agentbase-python/compare/v0.4.0...v0.5.0)
Expand Down
37 changes: 4 additions & 33 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Visit the Agentbase API documentation [here](https://docs.agentbase.sh/).
<!-- prettier-ignore -->
[![PyPI version](https://img.shields.io/pypi/v/agentbase-sdk.svg?label=pypi%20(stable))](https://pypi.org/project/agentbase-sdk/)

The Agentbase Python library provides convenient access to the Agentbase REST API from any Python 3.8+
The Agentbase Python library provides convenient access to the Agentbase REST API from any Python 3.9+
application. The library includes type definitions for all request params and response fields,
and offers both synchronous and asynchronous clients powered by [httpx](https://github.com/encode/httpx).

Expand Down Expand Up @@ -85,14 +85,15 @@ pip install agentbase-sdk[aiohttp]
Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:

```python
import os
import asyncio
from agentbase import DefaultAioHttpClient
from agentbase import AsyncAgentbase


async def main() -> None:
async with AsyncAgentbase(
api_key="My API Key",
api_key=os.environ.get("AGENTBASE_API_KEY"), # This is the default and can be omitted
http_client=DefaultAioHttpClient(),
) as client:
response = await client.run_agent(
Expand All @@ -103,36 +104,6 @@ async def main() -> None:
asyncio.run(main())
```

## Streaming responses

We provide support for streaming responses using Server Side Events (SSE).

```python
from agentbase import Agentbase

client = Agentbase()

stream = client.run_agent(
message="REPLACE_ME",
)
for response in stream:
print(response)
```

The async client uses the exact same interface.

```python
from agentbase import AsyncAgentbase

client = AsyncAgentbase()

stream = await client.run_agent(
message="REPLACE_ME",
)
async for response in stream:
print(response)
```

## Using types

Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typing.html#typing.TypedDict). Responses are [Pydantic models](https://docs.pydantic.dev) which also provide helper methods for things like:
Expand Down Expand Up @@ -419,7 +390,7 @@ print(agentbase.__version__)

## Requirements

Python 3.8 or higher.
Python 3.9 or higher.

## Contributing

Expand Down
24 changes: 13 additions & 11 deletions pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,30 +1,32 @@
[project]
name = "agentbase-sdk"
version = "0.5.0"
version = "0.5.1"
description = "The official Python library for the agentbase API"
dynamic = ["readme"]
license = "Apache-2.0"
authors = [
{ name = "Agentbase", email = "[email protected]" },
]

dependencies = [
"httpx>=0.23.0, <1",
"pydantic>=1.9.0, <3",
"typing-extensions>=4.10, <5",
"anyio>=3.5.0, <5",
"distro>=1.7.0, <2",
"sniffio",
"httpx>=0.23.0, <1",
"pydantic>=1.9.0, <3",
"typing-extensions>=4.10, <5",
"anyio>=3.5.0, <5",
"distro>=1.7.0, <2",
"sniffio",
]
requires-python = ">= 3.8"

requires-python = ">= 3.9"
classifiers = [
"Typing :: Typed",
"Intended Audience :: Developers",
"Programming Language :: Python :: 3.8",
"Programming Language :: Python :: 3.9",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Programming Language :: Python :: 3.14",
"Operating System :: OS Independent",
"Operating System :: POSIX",
"Operating System :: MacOS",
Expand All @@ -46,7 +48,7 @@ managed = true
# version pins are in requirements-dev.lock
dev-dependencies = [
"pyright==1.1.399",
"mypy",
"mypy==1.17",
"respx",
"pytest",
"pytest-asyncio",
Expand Down Expand Up @@ -141,7 +143,7 @@ filterwarnings = [
# there are a couple of flags that are still disabled by
# default in strict mode as they are experimental and niche.
typeCheckingMode = "strict"
pythonVersion = "3.8"
pythonVersion = "3.9"

exclude = [
"_dev",
Expand Down
112 changes: 62 additions & 50 deletions requirements-dev.lock
Original file line number Diff line number Diff line change
Expand Up @@ -12,40 +12,45 @@
-e file:.
aiohappyeyeballs==2.6.1
# via aiohttp
aiohttp==3.12.8
aiohttp==3.13.2
# via agentbase-sdk
# via httpx-aiohttp
aiosignal==1.3.2
aiosignal==1.4.0
# via aiohttp
annotated-types==0.6.0
annotated-types==0.7.0
# via pydantic
anyio==4.4.0
anyio==4.12.0
# via agentbase-sdk
# via httpx
argcomplete==3.1.2
argcomplete==3.6.3
# via nox
async-timeout==5.0.1
# via aiohttp
attrs==25.3.0
attrs==25.4.0
# via aiohttp
certifi==2023.7.22
# via nox
backports-asyncio-runner==1.2.0
# via pytest-asyncio
certifi==2025.11.12
# via httpcore
# via httpx
colorlog==6.7.0
colorlog==6.10.1
# via nox
dependency-groups==1.3.1
# via nox
dirty-equals==0.6.0
distlib==0.3.7
dirty-equals==0.11
distlib==0.4.0
# via virtualenv
distro==1.8.0
distro==1.9.0
# via agentbase-sdk
exceptiongroup==1.2.2
exceptiongroup==1.3.1
# via anyio
# via pytest
execnet==2.1.1
execnet==2.1.2
# via pytest-xdist
filelock==3.12.4
filelock==3.19.1
# via virtualenv
frozenlist==1.6.2
frozenlist==1.8.0
# via aiohttp
# via aiosignal
h11==0.16.0
Expand All @@ -58,80 +63,87 @@ httpx==0.28.1
# via respx
httpx-aiohttp==0.1.9
# via agentbase-sdk
idna==3.4
humanize==4.13.0
# via nox
idna==3.11
# via anyio
# via httpx
# via yarl
importlib-metadata==7.0.0
iniconfig==2.0.0
importlib-metadata==8.7.0
iniconfig==2.1.0
# via pytest
markdown-it-py==3.0.0
# via rich
mdurl==0.1.2
# via markdown-it-py
multidict==6.4.4
multidict==6.7.0
# via aiohttp
# via yarl
mypy==1.14.1
mypy-extensions==1.0.0
mypy==1.17.0
mypy-extensions==1.1.0
# via mypy
nodeenv==1.8.0
nodeenv==1.9.1
# via pyright
nox==2023.4.22
packaging==23.2
nox==2025.11.12
packaging==25.0
# via dependency-groups
# via nox
# via pytest
platformdirs==3.11.0
pathspec==0.12.1
# via mypy
platformdirs==4.4.0
# via virtualenv
pluggy==1.5.0
pluggy==1.6.0
# via pytest
propcache==0.3.1
propcache==0.4.1
# via aiohttp
# via yarl
pydantic==2.11.9
pydantic==2.12.5
# via agentbase-sdk
pydantic-core==2.33.2
pydantic-core==2.41.5
# via pydantic
pygments==2.18.0
pygments==2.19.2
# via pytest
# via rich
pyright==1.1.399
pytest==8.3.3
pytest==8.4.2
# via pytest-asyncio
# via pytest-xdist
pytest-asyncio==0.24.0
pytest-xdist==3.7.0
python-dateutil==2.8.2
pytest-asyncio==1.2.0
pytest-xdist==3.8.0
python-dateutil==2.9.0.post0
# via time-machine
pytz==2023.3.post1
# via dirty-equals
respx==0.22.0
rich==13.7.1
ruff==0.9.4
setuptools==68.2.2
# via nodeenv
six==1.16.0
rich==14.2.0
ruff==0.14.7
six==1.17.0
# via python-dateutil
sniffio==1.3.0
sniffio==1.3.1
# via agentbase-sdk
# via anyio
time-machine==2.9.0
tomli==2.0.2
time-machine==2.19.0
tomli==2.3.0
# via dependency-groups
# via mypy
# via nox
# via pytest
typing-extensions==4.12.2
typing-extensions==4.15.0
# via agentbase-sdk
# via aiosignal
# via anyio
# via exceptiongroup
# via multidict
# via mypy
# via pydantic
# via pydantic-core
# via pyright
# via pytest-asyncio
# via typing-inspection
typing-inspection==0.4.1
# via virtualenv
typing-inspection==0.4.2
# via pydantic
virtualenv==20.24.5
virtualenv==20.35.4
# via nox
yarl==1.20.0
yarl==1.22.0
# via aiohttp
zipp==3.17.0
zipp==3.23.0
# via importlib-metadata
Loading