Skip to main content

Haiku

A clean, elegant command-line interface for chatting with local AI models via Ollama, featuring real-time Markdown rendering.

Features

  • 💬 Interactive chat interface with Ollama models
  • 📝 Real-time Markdown rendering (code blocks, tables, lists, etc.)
  • 🔄 Full conversation context preservation
  • 🎯 Customizable system prompts
  • 🌡️ Adjustable temperature settings
  • 💾 Conversation saving to files

Installation

pip install haiku-ollama 

Make sure you have Ollama installed and running before using Haiku.

Usage

Start a conversation with the default model (llama3.1:8b):

haiku 

Command Line Options

Option Description
--model Specify which Ollama model to use (default: llama3.1:8b)
--keep-context, -k Maintain full conversation history between prompts
--system, -s Set a custom system prompt to guide the model's behavior
--temperature, -t Set temperature (0.0-1.0) - lower values are more deterministic
--save Save the conversation to a specified file

Examples

Using a specific model:

haiku --model mistral:7b 

Preserving conversation context:

haiku --keep-context 

Setting a system prompt:

haiku --system "You are an expert programmer who explains code concisely" 

Adjusting temperature:

haiku --temperature 0.2 

Saving your conversation:

haiku --save conversation.md 

Combining multiple options:

haiku --model codellama --keep-context --system "You write Python code" --temperature 0.3 --save coding_session.md 

Exiting

To exit the program, simply type exit or bye, or press Ctrl+C.

Requirements

  • Python 3.8+
  • Ollama installed and running
  • Python packages: ollama, rich

Contributing

Contributions are welcome! Feel free to submit issues or pull requests.

License

MIT License

Metadata

Release files for haiku-ollama 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for haiku-ollama 0.1.0
File Size Uploaded
haiku_ollama-0.1.0.tar.gz 4.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for haiku-ollama 0.1.0
File Interpreter ABI Platform
haiku_ollama-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 9.7 kB

Release files / haiku_ollama-0.1.0.tar.gz

Download URL haiku_ollama-0.1.0.tar.gz
Size 4.7 kB
Tags Source
SHA-256 checksum
How to use checksums
e7d1464105dab07b77d4d0ecd8ebaeb1630394a4a5e804f9a359031e8c775286
BLAKE2b-256 checksum
How to use checksums
31ea08af70e7a19af38c2d0500e7a077b6c94c213830ac2a230340e23fd57e8d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.7

Release files / haiku_ollama-0.1.0-py3-none-any.whl

Download URL haiku_ollama-0.1.0-py3-none-any.whl
Size 5.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
be404b05eda6c53b2f6573d81e0c0714c4830aca339b249476f91e30a2be622d
BLAKE2b-256 checksum
How to use checksums
1b6d2da0057f0e8bea2a3270f57fd275f02dc52dfb1ac235e13d48637c628bf4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.7

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page