zeph 0.19.0

Lightweight AI agent with hybrid inference, skills-first architecture, and multi-channel I/O
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

# Installation

The fastest way to get Zeph running is the install script. Alternative methods (crates.io, source, binaries, Docker) are listed below.

## Install Script (recommended)

Run the one-liner to download and install the latest release:

```bash
curl -fsSL https://github.com/bug-ops/zeph/releases/latest/download/install.sh | sh
```

The script detects your OS and architecture, downloads the binary to `~/.zeph/bin/zeph`, and adds it to your `PATH`. Override the install directory with `ZEPH_INSTALL_DIR`:

```bash
ZEPH_INSTALL_DIR=/usr/local/bin curl -fsSL https://github.com/bug-ops/zeph/releases/latest/download/install.sh | sh
```

Install a specific version:

```bash
curl -fsSL https://github.com/bug-ops/zeph/releases/latest/download/install.sh | sh -s -- --version v0.18.5
```

Verify it works:

```bash
zeph --version
```

Then run the configuration wizard:

```bash
zeph init
```

See [Configuration Wizard](wizard.md) for a step-by-step walkthrough of `zeph init`.

## From crates.io

```bash
cargo install zeph
```

With optional features:

```bash
cargo install zeph --features tui,a2a
```

## From Source

Requires Rust 1.88+ (Edition 2024).

```bash
git clone https://github.com/bug-ops/zeph
cd zeph
cargo build --release
```

The binary is produced at `target/release/zeph`. Run `zeph init` to generate a config file.

Build with optional features for TUI, IDE integration, or server deployment:

```bash
cargo build --release --features desktop          # TUI dashboard
cargo build --release --features ide              # ACP for IDE integration
cargo build --release --features server           # HTTP gateway + A2A + OpenTelemetry
cargo build --release --features full             # all optional features
```

See [Feature Flags](../reference/feature-flags.md) for the complete list of build options.

## Pre-built Binaries

Download from [GitHub Releases](https://github.com/bug-ops/zeph/releases/latest):

| Platform | Architecture | Download |
|----------|-------------|----------|
| Linux | x86_64 | `zeph-x86_64-unknown-linux-gnu.tar.gz` |
| Linux | aarch64 | `zeph-aarch64-unknown-linux-gnu.tar.gz` |
| macOS | x86_64 | `zeph-x86_64-apple-darwin.tar.gz` |
| macOS | aarch64 | `zeph-aarch64-apple-darwin.tar.gz` |
| Windows | x86_64 | `zeph-x86_64-pc-windows-msvc.zip` |

## Docker

Pull the latest image from GitHub Container Registry:

```bash
docker pull ghcr.io/bug-ops/zeph:latest
```

Or use a specific version:

```bash
docker pull ghcr.io/bug-ops/zeph:v0.18.5
```

Images are scanned with [Trivy](https://trivy.dev/) in CI/CD and use Oracle Linux 9 Slim base with **0 HIGH/CRITICAL CVEs**. Multi-platform: linux/amd64, linux/arm64.

See [Docker Deployment](../guides/docker.md) for full deployment options including GPU support and age vault.

## Next Steps

- [Configuration Wizard](wizard.md) — generate a config with `zeph init`
- [First Conversation](first-conversation.md) — send your first message