Metadata-Version: 2.5
Name: collimate
Version: 0.1.0
Summary: Collimate
Project-URL: Homepage, https://github.com/mike-droptables/collimate
Project-URL: Repository, https://github.com/mike-droptables/collimate
Project-URL: Issues, https://github.com/mike-droptables/collimate/issues
Author: Collimate contributors
License-Expression: MIT
License-File: LICENSE
Keywords: collimate,generators,llm,renderers,workbench
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.13
Requires-Dist: collimate-sdk==0.1.0
Requires-Dist: docker>=7.0.0
Requires-Dist: fastapi>=0.100.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: keyring>=25.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: uvicorn>=0.23.0
Requires-Dist: websockets<18,>=17
Description-Content-Type: text/markdown

# collimate

The Collimate server: a local-first workbench for working with language
models in parallel. Fan a problem out across generators, compare the results
side by side and keep what holds up. Every branch, draft and rejected
alternative persists as a versioned artifact.

This distribution is the server and its web UI. It bundles the first-party
generators, renderers and built-ins, and the frozen module graph those
renderers import, so it runs offline. Generators and renderers are written
against [`collimate-sdk`](https://pypi.org/project/collimate-sdk/), which it
depends on at the same version.

## Run it

```
uvx collimate
```

The server binds loopback only (`127.0.0.1`, port 5001) and prints the URL to
open in a browser. To keep it installed, use `uv tool install collimate`.

- `--port N` serves on another port.
- `--data-dir PATH` keeps state in `PATH/.collimate/`. Without it the data
  directory is `$COLLIMATE_DATA`, else the current directory. It is created
  if missing.
- `--token TOKEN` (or `$COLLIMATE_TOKEN`) requires a bearer token on every
  request except `GET /health`. Use it to serve the desktop app through a TLS
  reverse proxy. The server itself still binds loopback only.

Requires Python 3.13 or later on Linux or macOS. Docker is optional; it is
used for sandboxed generator runs.

## More

Source, the desktop app and documentation:
<https://github.com/mike-droptables/collimate>. MIT licensed.
