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)
| File | Size | Uploaded | |
|---|---|---|---|
| haiku_ollama-0.1.0.tar.gz | 4.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|