# go-ollama

Ergonomic Go client for `github.com/ollama/ollama/api`.

**Canonical spec:** [docs/project-specification.md](./docs/project-specification.md) — follow it for design and implementation.

## Stack

- **Language:** Go (see workspace `go.work` for version)
- **Module:** `gitea.neitzel.de/konrad/go-ollama`, package `gollama`
- **Wraps:** `github.com/ollama/ollama/api` — do not reimplement HTTP

## Design (summary)

- Default to non-streaming (`stream: false`); aggregate into `Result`
- `CallOption` for per-request overrides; `OptionSet` fluent builder for generation options
- `Session` for multi-turn chat with automatic history
- Project docs override workspace defaults for this module

## Integration tests

- Default Ollama host: `http://debian:11434` in `testconfig/defaults.toml`
- Override via `testconfig/local.toml` (gitignored) or `OLLAMA_HOST`
- Run: `go test -tags=integration ./...`

## Work tracking

Local markdown issues: [../.scratch/](../.scratch/) — see [docs/agents/issue-tracker.md](../docs/agents/issue-tracker.md).