ollama-python/examples/README.md

Running Examples

Run the examples in this directory with:

# Run example
python3 examples/<example>.py

See ollama/docs/api.md for full API documentation

Chat - Chat with a model

• chat.py
• async-chat.py
• chat-stream.py - Streamed outputs
• chat-with-history.py - Chat with model and maintain history of the conversation

Generate - Generate text with a model

• generate.py
• async-generate.py
• generate-stream.py - Streamed outputs
• fill-in-middle.py - Given a prefix and suffix, fill in the middle

Tools/Function Calling - Call a function with a model

• tools.py - Simple example of Tools/Function Calling
• async-tools.py
• multi-tool.py - Using multiple tools, with thinking enabled

gpt-oss

• gpt-oss-tools.py
• gpt-oss-tools-stream.py
• gpt-oss-tools-browser.py - Using browser research tools with gpt-oss
• gpt-oss-tools-browser-stream.py - Using browser research tools with gpt-oss, with streaming enabled

Multimodal with Images - Chat with a multimodal (image chat) model

• multimodal-chat.py
• multimodal-generate.py

Structured Outputs - Generate structured outputs with a model

• structured-outputs.py
• async-structured-outputs.py
• structured-outputs-image.py

Ollama List - List all downloaded models and their properties

• list.py

Ollama Show - Display model properties and capabilities

• show.py

Ollama ps - Show model status with CPU/GPU usage

• ps.py

Ollama Pull - Pull a model from Ollama

Requirement: pip install tqdm

• pull.py

Ollama Create - Create a model from a Modelfile

• create.py

Ollama Embed - Generate embeddings with a model

• embed.py

Thinking - Enable thinking mode for a model

• thinking.py

Thinking (generate) - Enable thinking mode for a model

• thinking-generate.py

Thinking (levels) - Choose the thinking level

• thinking-levels.py

MCP server - Expose web search and crawl tools to MCP clients

Requires: pip install mcp

• mcp_web_search_crawl_server.py

Run via stdio (for Cursor/Claude MCP):

python3 examples/mcp_web_search_crawl_server.py

Optional environment:

• OLLAMA_API_KEY: If set, will be passed as an Authorization header for Ollama hosted web search/crawl APIs.