PyPI · #1027 most downloaded on PyPI

ollama

0.6.313M downloads/moollama/ollama-python ↗New releases in your daily digest, changelog included.

The official Python client for Ollama.

Last release 6 days ago
29 Sep 2026
Release timing varies
gaps range from 8 days to 6 months
Nearly every release is documented
notes for 35 of 36 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
36 releases · first in 2024

Release timeline

36 releases since 2024

202420252026

Releases

0.6.329 Sept 2026
client: widen sync generate think type to accept string levels by @anxkhn in #697
What's Changed

client: widen sync generate think type to accept string levels by @anxkhn in #697

fix: handle multiple tool calls in tools examples by @Krishnachaitanyakc in #634

types: make Image path extension check case-insensitive by @anxkhn in #696

readme: update to use gemma 4 and format by @ParthSareen in #740

feat: add System One API support by @ParthSareen in #749

Create pylint.yml by @eoinmcgee1993 in #731

types/client: relax think type to support model-defined thinking levels by @arrase in #744

New Contributors

@anxkhn made their first contribution in #697

@Krishnachaitanyakc made their first contribution in #634

@eoinmcgee1993 made their first contribution in #731

@arrase made their first contribution in #744

Full Changelog: v0.6.2...v0.6.3

0.6.229 Apr 2026

docs(readme): add Cloud Models Python usage and Cloud API example by @eden-chan in #595

What's Changed

docs(readme): add Cloud Models Python usage and Cloud API example by @eden-chan in #595
client: expose resource cleanup methods by @ParthSareen in #444
build(deps): bump actions/checkout from 5 to 6 by @dependabot[bot] in #602
Add image generation support by @jmorganca in #616

New Contributors

@eden-chan made their first contribution in #595

Full Changelog: v0.6.1...v0.6.2

Open source →

0.6.024 Sept 2025

client: add web search and web crawl capabilities by @ParthSareen in #578

What's Changed

client: add web search and web crawl capabilities by @ParthSareen in #578
client: load OLLAMA_API_KEY on init by @ParthSareen in #583
client/types: update web search and fetch API by @npardal in #584
examples: add mcp server for web_search web_crawl by @ParthSareen in #585
examples: gpt oss browser tool by @ParthSareen in #588

New Contributors

@npardal made their first contribution in #584

Full Changelog: v0.5.4...v0.6.0

Open source →

0.5.416 Sept 2025

examples: add gpt-oss browser example by @ParthSareen in #558

What's Changed

examples: add gpt-oss browser example by @ParthSareen in #558
build(deps): bump actions/checkout from 4 to 5 by @dependabot[bot] in #559
examples/gpt-oss: fix examples by @ParthSareen in #566
Fix link for thinking-levels.py in documentation by @btjanaka in #567
examples: fix gpt-oss-tools-stream for adding tool calls by @ParthSareen in #568
examples: resolve invalid tool usage status code 400 if llm makes a mistake gpt-oss by @MarkWard0110 in #569
build(deps): bump actions/setup-python from 5 to 6 by @dependabot[bot] in #571
feat: add dimensions to embed request by @mxyng in #574

New Contributors

@btjanaka made their first contribution in #567
@MarkWard0110 made their first contribution in #569

Full Changelog: v0.5.3...v0.5.4

Open source →

0.5.25 Aug 2025

types/examples: add tool_name to message and examples by @ParthSareen in #537

What's Changed

types/examples: add tool_name to message and examples by @ParthSareen in #537
types: add context_length to ProcessResponse by @ParthSareen in #538
types: relax type for tools by @ParthSareen in #550
add license metadata to package by @ViViDboarder in #526

New Contributors

@hwittenborn made their first contribution in #525
@ViViDboarder made their first contribution in #526

Full Changelog: v0.5.1...v0.5.2

Open source →

0.4.816 Apr 2025

client: add support for passing in Image type to generate by @ParthSareen in #408

What's Changed

client: add support for passing in Image type to generate by @ParthSareen in #408
types: relax enum type for tool by @ParthSareen in #498
types: allow single or multiple types tool property by @ParthSareen in #499
types: enable passing messages with arbitrary role by @rylativity in #462
types: allow items and defs for tools by @ParthSareen in #501
examples: update tools.py to nicely manage numbers instead of concat strings by @ddbit in #443
examples: fix example links by @ansent788 in #461
chore: add SECURITY.md by @ParthSareen in #479
poetry: update dependencies by @ParthSareen in #505

New Contributors

@ddbit made their first contribution in #443
@rylativity made their first contribution in #462
@ansent788 made their first contribution in #461

Full Changelog: v0.4.7...v0.4.8

Open source →

0.4.721 Jan 2025

client: remove sha256 as it's already available in the digest by @samhita-alla in https://github.com/ollama/ollama-python/pull/420

What's Changed

client: remove sha256 as it's already available in the digest by @samhita-alla in https://github.com/ollama/ollama-python/pull/420
client: improve error messaging on connection failure by @ParthSareen in https://github.com/ollama/ollama-python/pull/398
chore: bump httpx from 0.27.2 to 0.28.1 by @dependabot in https://github.com/ollama/ollama-python/pull/365
chore: ensure imports are sorted by @akx in https://github.com/ollama/ollama-python/pull/385
examples: fix create examples by @jmorganca in https://github.com/ollama/ollama-python/pull/421
examples: update create example by @ParthSareen in https://github.com/ollama/ollama-python/pull/418
fix: don't run lints on all Python versions by @akx in https://github.com/ollama/ollama-python/pull/400
fix: formatting & CI by @akx in https://github.com/ollama/ollama-python/pull/422
chore: add tests for checking sha in blob request by @ParthSareen in https://github.com/ollama/ollama-python/pull/425

New Contributors

@samhita-alla made their first contribution in https://github.com/ollama/ollama-python/pull/420

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.4.6...v0.4.7

Open source →

0.4.614 Jan 2025

add create api changes to support ollama v0.5.5 by @pdevine in https://github.com/ollama/ollama-python/pull/417

What's Changed

add create api changes to support ollama v0.5.5 by @pdevine in https://github.com/ollama/ollama-python/pull/417

New Contributors

@pdevine made their first contribution in https://github.com/ollama/ollama-python/pull/417

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.4.5...v0.4.6

Open source →

0.4.529 Dec 2024

examples: remove extra print by @ParthSareen in https://github.com/ollama/ollama-python/pull/364

What's Changed

examples: remove extra print by @ParthSareen in https://github.com/ollama/ollama-python/pull/364
examples: use type hinting generics in standard collections. by @fujitatomoya in https://github.com/ollama/ollama-python/pull/389
bugfix: export Image model by @akx in https://github.com/ollama/ollama-python/pull/384
bugfix: fix passing Image type in messages for chat @ParthSareen in https://github.com/ollama/ollama-python/pull/390

New Contributors

@akx made their first contribution in https://github.com/ollama/ollama-python/pull/384
@fujitatomoya made their first contribution in https://github.com/ollama/ollama-python/pull/389

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.4.4...v0.4.5

Open source →

0.4.48 Dec 2024

fix validation of format to allow empty strings as it did previously by @jmorganca in https://github.com/ollama/ollama-python/pull/369

What's Changed

fix validation of format to allow empty strings as it did previously by @jmorganca in https://github.com/ollama/ollama-python/pull/369

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.4.3...v0.4.4

Open source →

0.4.36 Dec 2024

Improve tool example to showcase chatting by @ParthSareen in https://github.com/ollama/ollama-python/pull/352

What's Changed

Improve tool example to showcase chatting by @ParthSareen in https://github.com/ollama/ollama-python/pull/352
Bump pytest from 8.3.3 to 8.3.4 by @dependabot in https://github.com/ollama/ollama-python/pull/358
Structured outputs support with examples by @ParthSareen in https://github.com/ollama/ollama-python/pull/354

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.4.2...v0.4.3

Open source →

0.4.228 Nov 2024

Fix message append in example chat-with-history.py to overcome runtime error. by @shahil-yadav in https://github.com/ollama/ollama-python/pull/337

What's Changed

Fix message append in example chat-with-history.py to overcome runtime error. by @shahil-yadav in https://github.com/ollama/ollama-python/pull/337
Make subscriptable methods more consistent with __contains__ by @jmorganca in https://github.com/ollama/ollama-python/pull/336
Fix Client.chat overloaded type annotations by @pythongirl325 in https://github.com/ollama/ollama-python/pull/344
Fix image serialization for long image string by @ParthSareen in https://github.com/ollama/ollama-python/pull/348

New Contributors

@shahil-yadav made their first contribution in https://github.com/ollama/ollama-python/pull/337
@pythongirl325 made their first contribution in https://github.com/ollama/ollama-python/pull/344

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.4.1...v0.4.2

Open source →

0.4.124 Nov 2024

Fixed issue where message types would have a tool_calls field by membership test even if no tool calls were provided by the response.

What's Changed

Fixed issue where message types would have a tool_calls field by membership test even if no tool calls were provided by the response.

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.4.0...v0.4.1

Open source →

0.4.021 Nov 2024Deprecated

Deprecate embeddings from docs in favor of embed by @royjhan in https://github.com/ollama/ollama-python/pull/216

New Features

Add Pydantic for validation and serialization by @mxyng in https://github.com/ollama/ollama-python/pull/276
Passing Functions as Tools by @ParthSareen in https://github.com/ollama/ollama-python/pull/321
No head request for create blob by @mxyng in https://github.com/ollama/ollama-python/pull/277
Deprecate embeddings from docs in favor of embed by @royjhan in https://github.com/ollama/ollama-python/pull/216

Chores

Examples refactor by @ParthSareen in https://github.com/ollama/ollama-python/pull/329
chore: add python3.13 to test matrix by @mxyng in https://github.com/ollama/ollama-python/pull/324
Update requirements.txt and poetry.lock by @ParthSareen in https://github.com/ollama/ollama-python/pull/315
update pyproject.toml by @mxyng in https://github.com/ollama/ollama-python/pull/284
Bump pytest from 8.3.2 to 8.3.3 by @dependabot in https://github.com/ollama/ollama-python/pull/278
Bump ruff from 0.6.3 to 0.6.5 by @dependabot in https://github.com/ollama/ollama-python/pull/281
Bump pydantic from 2.9.0 to 2.9.2 by @dependabot in https://github.com/ollama/ollama-python/pull/318
Bump ruff from 0.6.9 to 0.7.4 by @dependabot in https://github.com/ollama/ollama-python/pull/322
add basic delete/copy tests by @mxyng in https://github.com/ollama/ollama-python/pull/275

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.3.3...v0.4.0

Open source →

0.3.39 Sept 2024

_stream in async client raises RuntimeError when processing HTTP errors by @Oneirag in https://github.com/ollama/ollama-python/pull/266

What's Changed

_stream in async client raises RuntimeError when processing HTTP errors by @Oneirag in https://github.com/ollama/ollama-python/pull/266
Bump ruff from 0.6.2 to 0.6.3 by @dependabot in https://github.com/ollama/ollama-python/pull/267

New Contributors

@Oneirag made their first contribution in https://github.com/ollama/ollama-python/pull/266

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.3.2...v0.3.3

Open source →

0.3.227 Aug 2024

Add URL path to client URL in in Client._parse_host() by @bplunkert in https://github.com/ollama/ollama-python/pull/170

What's Changed

Add URL path to client URL in in Client._parse_host() by @bplunkert in https://github.com/ollama/ollama-python/pull/170
IPv6 support by @jbinder in https://github.com/ollama/ollama-python/pull/262
Bump pytest-httpserver from 1.0.12 to 1.1.0 by @dependabot in https://github.com/ollama/ollama-python/pull/252
Bump pytest-asyncio from 0.23.8 to 0.24.0 by @dependabot in https://github.com/ollama/ollama-python/pull/260
Bump ruff from 0.5.5 to 0.6.2 by @dependabot in https://github.com/ollama/ollama-python/pull/261

New Contributors

@bplunkert made their first contribution in https://github.com/ollama/ollama-python/pull/170
@jbinder made their first contribution in https://github.com/ollama/ollama-python/pull/262

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.3.1...v0.3.2

Open source →

0.3.129 Jul 2024

update to llama3.1 by @jmorganca in https://github.com/ollama/ollama-python/pull/237

What's Changed

update to llama3.1 by @jmorganca in https://github.com/ollama/ollama-python/pull/237
fix: tool_calls response parsing by @zeelrupapara in https://github.com/ollama/ollama-python/pull/236
Update Message annotations to support tool calls by @Shulyaka in https://github.com/ollama/ollama-python/pull/227

New Contributors

@jmorganca made their first contribution in https://github.com/ollama/ollama-python/pull/237
@zeelrupapara made their first contribution in https://github.com/ollama/ollama-python/pull/236
@Shulyaka made their first contribution in https://github.com/ollama/ollama-python/pull/227

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.3.0...v0.3.1

Open source →

0.3.018 Jul 2024

Simple Example by @royjhan in https://github.com/ollama/ollama-python/pull/179

What's Changed

Simple Example by @royjhan in https://github.com/ollama/ollama-python/pull/179
Add type overloads to methods by @royjhan in https://github.com/ollama/ollama-python/pull/181
integrate tool calls by @joshyan1 in https://github.com/ollama/ollama-python/pull/213
Support api/embed by @royjhan in https://github.com/ollama/ollama-python/pull/208
add insert support to generate endpoint by @royjhan in https://github.com/ollama/ollama-python/pull/215

New Contributors

@joshyan1 made their first contribution in https://github.com/ollama/ollama-python/pull/213

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.2.1...v0.3.0

Open source →

0.2.15 Jun 2024

add done reason to generate type responses by @BruceMacD in https://github.com/ollama/ollama-python/pull/154

What's Changed

add done reason to generate type responses by @BruceMacD in https://github.com/ollama/ollama-python/pull/154
Python API PS by @royjhan in https://github.com/ollama/ollama-python/pull/177
Avoid side effects if chat message contains images by @tillfalko in https://github.com/ollama/ollama-python/pull/158
Add py.typed to mark the library as typed by @davep in https://github.com/ollama/ollama-python/pull/129

New Contributors

@royjhan made their first contribution in https://github.com/ollama/ollama-python/pull/177
@tillfalko made their first contribution in https://github.com/ollama/ollama-python/pull/158
@davep made their first contribution in https://github.com/ollama/ollama-python/pull/129

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.2.0...v0.2.1

Open source →

0.2.010 May 2024

doc(README) : add prerequisites by @adriens in https://github.com/ollama/ollama-python/pull/45

What's Changed

doc(README) : add prerequisites by @adriens in https://github.com/ollama/ollama-python/pull/45
fix: annotation in AsyncClient.embedding by @jingfelix in https://github.com/ollama/ollama-python/pull/145
Update README.md by @TitanStar73 in https://github.com/ollama/ollama-python/pull/138
Update README.md link still point legacy url by @veinkr in https://github.com/ollama/ollama-python/pull/135
remove old options by @mxyng in https://github.com/ollama/ollama-python/pull/152
add quantization to create requests by @mxyng in https://github.com/ollama/ollama-python/pull/150

[!NOTE] Generate and chat options num_gqa, rope_frequency_base, and rope_frequency_scale has been removed.

New Contributors

@adriens made their first contribution in https://github.com/ollama/ollama-python/pull/45
@jingfelix made their first contribution in https://github.com/ollama/ollama-python/pull/145
@TitanStar73 made their first contribution in https://github.com/ollama/ollama-python/pull/138
@veinkr made their first contribution in https://github.com/ollama/ollama-python/pull/135

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.1.9...v0.2.0

Open source →

0.1.926 Apr 2024

modified embeddings return annotation by @N-Vlahovic in https://github.com/ollama/ollama-python/pull/114

What's Changed

modified embeddings return annotation by @N-Vlahovic in https://github.com/ollama/ollama-python/pull/114
fix 'content' check on messages in chat() by @DSLstandard in https://github.com/ollama/ollama-python/pull/118

New Contributors

@N-Vlahovic made their first contribution in https://github.com/ollama/ollama-python/pull/114
@DSLstandard made their first contribution in https://github.com/ollama/ollama-python/pull/118

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.1.8...v0.1.9

Open source →

0.1.71 Mar 2024

create example by @mxyng in https://github.com/ollama/ollama-python/pull/52

What's Changed

create example by @mxyng in https://github.com/ollama/ollama-python/pull/52
python user agent by @mxyng in https://github.com/ollama/ollama-python/pull/58

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.1.6...v0.1.7

Open source →

0.1.62 Feb 2024

fix: encode base64 inputs by @mxyng in https://github.com/ollama/ollama-python/pull/50

What's Changed

fix: encode base64 inputs by @mxyng in https://github.com/ollama/ollama-python/pull/50
add keep_alive by @mxyng in https://github.com/ollama/ollama-python/pull/31

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.1.5...v0.1.6

Open source →

0.1.530 Jan 2024

update github actions by @mxyng in https://github.com/ollama/ollama-python/pull/32

What's Changed

update github actions by @mxyng in https://github.com/ollama/ollama-python/pull/32
error handling code by @chenxizhang in https://github.com/ollama/ollama-python/pull/34
fix parse modelfile by @mxyng in https://github.com/ollama/ollama-python/pull/40
Update README.md by @rachfop in https://github.com/ollama/ollama-python/pull/41

New Contributors

@chenxizhang made their first contribution in https://github.com/ollama/ollama-python/pull/34
@rachfop made their first contribution in https://github.com/ollama/ollama-python/pull/41

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.1.4...v0.1.5

Open source →

0.1.423 Jan 2024

update response error field to match json response by @mxyng in https://github.com/ollama/ollama-python/pull/17

What's Changed

update response error field to match json response by @mxyng in https://github.com/ollama/ollama-python/pull/17
upgrade pillow by @mxyng in https://github.com/ollama/ollama-python/pull/19
fix unit tests by @mxyng in https://github.com/ollama/ollama-python/pull/18
fix pull example typo by @BruceMacD in https://github.com/ollama/ollama-python/pull/20

Full Changelog: https://github.com/ollama/ollama-python/compare/v0.1.3...v0.1.4

Open source →

0.1.319 Jan 2024

> The base_url argument to ollama.Client and ollama.AsyncClient have been updated to match Ollama CLI. This also updates the keyword to host, for exam

[!IMPORTANT] The base_url argument to ollama.Client and ollama.AsyncClient have been updated to match Ollama CLI. This also updates the keyword to host, for example ollama.Client(host='http://my.remote.ollama').

What's Changed

ci: give publish job content perms by @mxyng in https://github.com/jmorganca/ollama-python/pull/11
add example for pulling with progress bar by @mxyng in https://github.com/jmorganca/ollama-python/pull/13
examples by @mxyng in https://github.com/jmorganca/ollama-python/pull/15
fix: update OLLAMA_HOST parsing to match ollama CLI by @mxyng in https://github.com/jmorganca/ollama-python/pull/16

Full Changelog: https://github.com/jmorganca/ollama-python/compare/v0.1.2...v0.1.3

Open source →

0.1.216 Jan 2024

s/target/destination/ by @mxyng in https://github.com/jmorganca/ollama-python/pull/9

What's Changed

s/target/destination/ by @mxyng in https://github.com/jmorganca/ollama-python/pull/9
Changed 'show' to use POST instead of GET by @easp in https://github.com/jmorganca/ollama-python/pull/10

New Contributors

@easp made their first contribution in https://github.com/jmorganca/ollama-python/pull/10

Full Changelog: https://github.com/jmorganca/ollama-python/compare/v0.1.0...v0.1.2

Open source →

0.1.012 Jan 2024

fix: remote create new file by @BruceMacD in https://github.com/jmorganca/ollama-python/pull/8

What's Changed

fix: remote create new file by @BruceMacD in https://github.com/jmorganca/ollama-python/pull/8

New Contributors

@BruceMacD made their first contribution in https://github.com/jmorganca/ollama-python/pull/8

Full Changelog: https://github.com/jmorganca/ollama-python/compare/v0.0.1...v0.1.0

Open source →