Skip to content

Commit b6a85cf

Browse files
gHashTagclaude
andcommitted
docs: IGLA v1.0 announce templates and install guide
Announce materials for community distribution: - v1_announce_templates.md: X/Telegram/Discord/Reddit posts - igla_install_guide.md: One-line install commands - v1_announce_report.md: Metrics tracking Target: 1,000 downloads Week 1 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent cad9a3d commit b6a85cf

3 files changed

Lines changed: 448 additions & 216 deletions

File tree

docs/igla_install_guide.md

Lines changed: 132 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,132 @@
1+
# IGLA v1.0 Quick Install Guide
2+
3+
**Version:** 1.0.0
4+
**Release:** https://github.com/gHashTag/trinity/releases/tag/v1.0.0-igla
5+
6+
---
7+
8+
## One-Line Install
9+
10+
### macOS (M1/M2/M3 Apple Silicon)
11+
12+
```bash
13+
curl -LO https://github.com/gHashTag/trinity/releases/download/v1.0.0-igla/igla-macos-arm64 && chmod +x igla-macos-arm64 && ./igla-macos-arm64
14+
```
15+
16+
### macOS (Intel)
17+
18+
```bash
19+
curl -LO https://github.com/gHashTag/trinity/releases/download/v1.0.0-igla/igla-macos-x64 && chmod +x igla-macos-x64 && ./igla-macos-x64
20+
```
21+
22+
### Linux x64
23+
24+
```bash
25+
curl -LO https://github.com/gHashTag/trinity/releases/download/v1.0.0-igla/igla-linux-x64 && chmod +x igla-linux-x64 && ./igla-linux-x64
26+
```
27+
28+
### Windows (PowerShell)
29+
30+
```powershell
31+
Invoke-WebRequest -Uri "https://github.com/gHashTag/trinity/releases/download/v1.0.0-igla/igla-windows-x64.exe" -OutFile "igla.exe"; .\igla.exe
32+
```
33+
34+
---
35+
36+
## Expected Output
37+
38+
```
39+
╔══════════════════════════════════════════════════════════════╗
40+
║ IGLA METAL GPU v2.0 — VSA ACCELERATION ║
41+
║ Scalable Benchmark | Dim: 300 | 8-thread SIMD ║
42+
║ φ² + 1/φ² = 3 = TRINITY ║
43+
╚══════════════════════════════════════════════════════════════╝
44+
45+
═══════════════════════════════════════════════════════════════
46+
SCALABLE BENCHMARK RESULTS
47+
═══════════════════════════════════════════════════════════════
48+
Vocab Size │ ops/s │ M elem/s │ Time(ms) │ Status
49+
───────────┼───────────┼──────────┼──────────┼────────────
50+
1000 │ 2389 │ 716.7 │ 418.6 │ 1K+
51+
5000 │ 1713 │ 2570.0 │ 583.7 │ 1K+
52+
10000 │ 3147 │ 9441.5 │ 317.7 │ 1K+
53+
25000 │ 4571 │ 34284.8 │ 218.8 │ 1K+
54+
50000 │ 4854 │ 72823.4 │ 206.0 │ PRODUCTION
55+
```
56+
57+
---
58+
59+
## Binary Sizes
60+
61+
| Platform | Binary | Size |
62+
|----------|--------|------|
63+
| macOS ARM64 | `igla-macos-arm64` | 264 KB |
64+
| macOS x64 | `igla-macos-x64` | 271 KB |
65+
| Linux x64 | `igla-linux-x64` | 2.3 MB |
66+
| Windows x64 | `igla-windows-x64.exe` | 543 KB |
67+
68+
---
69+
70+
## System Requirements
71+
72+
| Platform | Minimum |
73+
|----------|---------|
74+
| macOS | macOS 11+ (Big Sur) |
75+
| Linux | glibc 2.17+ (CentOS 7+) |
76+
| Windows | Windows 10+ |
77+
| RAM | 64 MB (50K vocab) |
78+
| CPU | Any x64/ARM64 |
79+
80+
---
81+
82+
## Troubleshooting
83+
84+
### macOS: "cannot be opened because the developer cannot be verified"
85+
86+
```bash
87+
xattr -d com.apple.quarantine igla-macos-arm64
88+
```
89+
90+
### Linux: Permission denied
91+
92+
```bash
93+
chmod +x igla-linux-x64
94+
```
95+
96+
### Windows: SmartScreen warning
97+
98+
Click "More info" → "Run anyway"
99+
100+
---
101+
102+
## Performance Tips
103+
104+
1. **M1/M2/M3 Mac:** Use ARM64 binary (264KB, fastest)
105+
2. **Intel Mac:** Use x64 binary
106+
3. **Linux:** Ensure glibc 2.17+ installed
107+
4. **Windows:** Run from PowerShell for best output
108+
109+
---
110+
111+
## Build from Source
112+
113+
```bash
114+
git clone https://github.com/gHashTag/trinity.git
115+
cd trinity
116+
zig build-exe src/vibeec/igla_metal_gpu.zig -O ReleaseFast
117+
./igla_metal_gpu
118+
```
119+
120+
Requires: Zig 0.15.x
121+
122+
---
123+
124+
## Links
125+
126+
- **Release:** https://github.com/gHashTag/trinity/releases/tag/v1.0.0-igla
127+
- **Repository:** https://github.com/gHashTag/trinity
128+
- **Documentation:** https://gHashTag.github.io/trinity
129+
130+
---
131+
132+
**φ² + 1/φ² = 3 = TRINITY**

0 commit comments

Comments
 (0)