Skip to main content

sai

Simple AI interface to chat with your Ollama models from the terminal

Features

  • Pretty print real time responses in Markdown, using rich library.
  • Keep conversation context.
  • Autodetect and option to select models.
  • Add support for custom prompts.
  • Add custom roles (reusable prompts).
  • Improve performance by preloading models.
  • Add conversation persistency (sessions).

Requirements

An Ollama instance is required to get access to local models. By default, the URL is set to http://localhost:11434.

Install

You can install it using any package manager of your preference like pip, but the recommended way is uv tool.

Recommended

Using uv:

uv tool install sai-chat

Usage

Start using it in your terminal just by running sai command:

luis@laptop:~ $ sai
╭───────────────────────────────────────────────────────╮
│ Welcome to Sai. Chat with your local LLM models.      │
│                                                       │
│ Available commands:                                   │
│                                                       │
│  • /setup : Setup Ollama URL and preferences          │
│  • /model : Select a model                            │
│  • /roles : List and select a role                    │
│  • /role add : Create a new custom role               │
│  • /role delete : Delete a custom role                │
│  • /help : Show this help message                     │
│  • /quit : Exit the application                       │
╰───────────────────────────────────────────────────────╯
> hi
╭───────────────────────────────── Virtual Assistant ✔ ─╮
│ Hi there! How can I help you today? 😊                │
╰────────────────────── gemma3:1b ──────────────────────╯
> 

Status

This project is under development. Feel free to contribute or provide feedback!

Metadata

Release files for sai-chat 0.1.5

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

Source distribution (sdist)

Source distribution for sai-chat 0.1.5
File Size Uploaded
sai_chat-0.1.5.tar.gz 7.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sai-chat 0.1.5
File Interpreter ABI Platform
sai_chat-0.1.5-py3-none-any.whl Python 3 none any Details

Total release size: 17.4 kB

Release files / sai_chat-0.1.5.tar.gz

Download URL sai_chat-0.1.5.tar.gz
Size 7.4 kB
Tags Source
SHA-256 checksum
How to use checksums
7f77a71820272c0543de7076edcab4f3ef549ec9eeb2707fed62e3f813ee8cd2
BLAKE2b-256 checksum
How to use checksums
d77264d670f0bcf084bc761412751f558db20516b942e2eac85b5c6da0678844
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.5.13

Release files / sai_chat-0.1.5-py3-none-any.whl

Download URL sai_chat-0.1.5-py3-none-any.whl
Size 9.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cdc97575870d6c4091209d1c7f781749dd8c7191e9956c0a053619816eb53353
BLAKE2b-256 checksum
How to use checksums
237633cb36d40de35ba7815751cc5b8373fd9133ea95901ea85f366af2af8a2e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.5.13

Release history Release notifications | RSS feed

This release

0.1.5 This release

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

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