https://github.com/jmkraus/picochat
AI CLI chat client for AI LLM's, mainly written for Pico AI Server on Mac. But also works well with ollama.
https://github.com/jmkraus/picochat
ai-tools chat-application cli-app llmchat ollama-app ollama-client ollama-interface openai openai-cli openai-client openai-compatible
Last synced: 9 days ago
JSON representation
AI CLI chat client for AI LLM's, mainly written for Pico AI Server on Mac. But also works well with ollama.
- Host: GitHub
- URL: https://github.com/jmkraus/picochat
- Owner: jmkraus
- License: mit
- Created: 2025-05-09T15:55:13.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-21T16:21:14.000Z (10 days ago)
- Last Synced: 2026-05-22T00:59:10.668Z (10 days ago)
- Topics: ai-tools, chat-application, cli-app, llmchat, ollama-app, ollama-client, ollama-interface, openai, openai-cli, openai-client, openai-compatible
- Language: Go
- Homepage:
- Size: 14.2 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PicoChat
A lightweight terminal chat client for local and OpenAI-compatible LLM backends.
## Introduction
PicoChat provides an interactive CLI workflow with multiline input, session history, structured output options, and image-capable prompts.
## Key Features
- Interactive multiline chat input (`Ctrl+D` submit, `Esc`/`Ctrl+C` cancel)
- Session history save/load
- Multiple backend protocols (`ollama`, `openai`, `responses`)
- Output formatting (`plain`, `json`, `json-pretty`, `yaml`)
- Structured content generation via JSON schema
- Image prompt support
- Clipboard helpers and runtime commands
## Installation
Build from source:
```bash
go mod download
go mod tidy
go test ./...
go build
```
On macOS, unsigned binaries may need quarantine removal:
```bash
sudo xattr -rd com.apple.quarantine ./picochat
```
## Quick Start
Interactive mode:
```bash
./picochat
```
Pipe mode:
```bash
echo "Write a Haiku about Cheese" | ./picochat -quiet
```
## Documentation
Detailed guides are in [`/docs`](docs):
- [Usage Guide](docs/usage.md)
- [Configuration](docs/configuration.md)
- [Output and Structured Content](docs/output-and-structured-content.md)
- [Image Processing](docs/image-processing.md)
- [Debug and Known Issues](docs/debug-and-known-issues.md)
## Acknowledgements
- [BurntSushi/toml](https://github.com/BurntSushi/toml)
- [atotto/clipboard](https://github.com/atotto/clipboard)
- [mattn/go-runewidth](https://github.com/mattn/go-runewidth)
## License
MIT