# Remote Brain (rbrain)

## An mTLS terminal client for Ollama APIs

[rbrain](https://code.kevwe.com/rbrain.git) is a minimalistic, secure terminal client for calling remote Ollama APIs.

## Quick Start

### Configuration File

Create the following example configuration file:

```
$ cat $HOME/.config/rbrain/config.json
{
  "endpoint": "https://<your-host>:<your-port>/api/generate",
  "model": "llama3.2",
  "dbfile": "/home/user/.config/rbrain/history.db",
  "tlsCertificate": "/some/path/to/certificate.pem",
  "tlsKeyFile": "/some/path/to/secret/key.pem",
  "tlsVerifyServer": "do-not-ever-skip"
}
```

### Building RBrain

```bash
$ make
```

### Running RBrain

You can just run the executable:

```bash
$ ./build/rbrain
```

## License

RBrain is authored by [Paolo Lulli](https://lulli.net/about) 2026 and is publicly available under the Affero GPL license.