stout 0.2.1

A fast, Rust-based Homebrew-compatible package manager
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

# Stout

**A fast, Rust-based Homebrew-compatible package manager**

Stout is a drop-in replacement for the Homebrew CLI that's 10-100x faster for common operations. It eliminates Ruby entirely and uses pre-computed SQLite indexes with FTS5 full-text search.

---

## Why Stout?

| Operation | brew | stout | Speedup |
|-----------|------|-------|---------|
| `--version` | 500ms | 5ms | **100x** |
| `search json` | 2-5s | <50ms | **40-100x** |
| `info wget` | 1-2s | <100ms | **10-20x** |
| `update` | 10-60s | 1-3s | **10-20x** |

### What Makes Stout Fast

- **No Ruby interpreter** - Native Rust binary with 5ms startup vs 500ms
- **No git operations** - HTTP GET for 1-2MB index vs 700MB+ git repo
- **Pre-computed metadata** - JSON indexed in SQLite, no runtime DSL evaluation
- **SQLite FTS5** - Full-text search indexed database queries
- **Parallel downloads** - Tokio async runtime with concurrent bottle fetching
- **Smart caching** - Hash-based invalidation for formula metadata

---

## Quick Install

```bash
curl -fsSL https://raw.githubusercontent.com/neul-labs/stout/main/install.sh | bash
```

Or install via package managers:

=== "npm"

    ```bash
    npm install -g stout-pkg
    ```

=== "pip"

    ```bash
    pip install stout-pkg
    ```

=== "gem"

    ```bash
    gem install stout-pkg
    ```

=== "Cargo"

    ```bash
    cargo install stout
    ```

---

## Basic Usage

```bash
# Search for packages
stout search python

# Install a package
stout install jq

# Show package info
stout info wget

# List installed packages
stout list

# Upgrade all packages
stout upgrade
```

---

## Feature Highlights

### Full Homebrew Compatibility

Stout works seamlessly alongside Homebrew:

- Uses the same Cellar structure (`/opt/homebrew/Cellar`)
- Creates compatible `INSTALL_RECEIPT.json` files
- Symlinks to the same prefix (`/opt/homebrew/bin`, etc.)
- Packages installed by either tool are visible to both

### 35+ Commands

Stout supports all common Homebrew operations:

- **Package Management**: install, uninstall, upgrade, update, outdated
- **Discovery**: search, info, list, deps, uses, why
- **Control**: pin, unpin, link, unlink, switch, rollback
- **System**: cleanup, doctor, config, services
- **Casks**: Full macOS/Linux application support
- **Enterprise**: Multi-prefix, bundle, snapshot, audit, mirror

### Security Built-In

- Ed25519 cryptographic signatures on all index updates
- SHA256 checksums for all package downloads
- HTTPS required for all network operations
- Sandboxed extraction with no arbitrary code execution

### Enterprise Ready

- Private index hosting - fork [stout-index](https://github.com/neul-labs/stout-index) for internal packages
- Multi-prefix isolation for project environments
- Air-gapped deployment with offline mirrors
- Vulnerability scanning with CVE database integration

---

## Next Steps

- [Installation Guide](getting-started.md) - Detailed installation instructions
- [Quick Start](quickstart.md) - Get up and running in minutes
- [Command Reference](commands.md) - Complete command documentation
- [Configuration](configuration.md) - Customize stout behavior