README.md

---
title: Sonic-Forage
emoji: 🍓
colorFrom: purple
colorTo: red
sdk: static
pinned: false
header: mini
---

```
╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║   🍓  S O N I C - F O R A G E                              ║
║                                                              ║
║   The World's First Autonomous DJ Operating System           ║
║                                                              ║
║   "The bass is strong with this one"                         ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝
```

# 🍓 Sonic-Forage

**Open-source AI DJ ecosystem. Given away for free. Starting a movement > getting paid.**

We could have sold it. We gave it away — because that's what the PLUR spirit demands.

---

## What We're Building

**Sonic-Forage** is a fully autonomous, open-source DJ operating system powered by [Hermes Agent](https://nousresearch.com) (Nous Research). It was built **entirely by AI** — zero human code, 14 repos, 390+ files, 13 live websites — and we're giving all of it away.

### The Stack

| Layer | What It Does |
|-------|-------------|
| 🎛️ **Autonomous DJ OS** | Full mixing engine — crossfader, EQ, BPM sync, AI copilot |
| ⌨️ **Unicode CDJ** | Terminal-native deck interface — no GUI needed |
| 🍄 **Harm Reduction Kit** | Rave safety resources — tested at festivals worldwide |
| 📖 **Rave Culture Field Guide** | Complete history from warehouse parties to autonomous systems |
| 🎯 **Master Prompt Arcade** | AI prompt templates for music generation |
| 📋 **Booking Kit** | Autonomous gig booking and scheduling |
| 🌌 **Intergalactic 2045 Tour** | 5-stop space rave festival framework |

---

## Models & Datasets

We release **LoRA adapters, datasets, and tools** for the community to fork, train, and build on.

### Models
- **DJ Vanta Funk Glitch Bass Drama LoRA** — Coming soon
- More adapters in the pipeline

### Datasets
- **strawberry-logo-dude** — Strawberry mascot character generation dataset
- Community datasets welcome — fork and contribute

---

## How To Use

```bash
# Clone the starter kit
git clone https://github.com/Sonic-Forage/sonic-forage-starter-kit.git
cd sonic-forage-starter-kit

# Install
chmod +x scripts/install.sh && ./scripts/install.sh

# Launch
python3 sonic_forage/launch.py --mode=autonomous
```

---

## Rave Culture Meets AI

Built on a foundation of:

- 📜 **R.A.V.E. Act analysis** — understanding the law that shaped electronic music
- 🏥 **Harm reduction** — safety-first approach to festival culture
- 🕊️ **PLUR philosophy** — Peace, Love, Unity, Respect
- 🔬 **Nous Research alignment** — open-source AI for everyone
- 🌍 **Community-first** — fork it, build it, play it

---

## Links

- 🐙 **GitHub:** [github.com/Sonic-Forage](https://github.com/Sonic-Forage)
- 🌐 **Starter Kit:** [sonic-forage.github.io/sonic-forage-starter-kit](https://sonic-forage.github.io/sonic-forage-starter-kit/)
- 📖 **Field Guide:** [sonic-forage.github.io/sonic-forage-rave-culture-field-guide](https://sonic-forage.github.io/sonic-forage-rave-culture-field-guide/)
- 🎛️ **Unicode CDJ:** [sonic-forage.github.io/sonic-forage-unicode-cdj](https://sonic-forage.github.io/sonic-forage-unicode-cdj/)
- 🌌 **2045 Tour:** [sonic-forage.github.io/sonic-forage-intergalactic-festival-2045-tour](https://sonic-forage.github.io/sonic-forage-intergalactic-festival-2045-tour/)
- 🧠 **Nous Research:** [nousresearch.com](https://nousresearch.com)

---

## Eclipse 2045

**August 11, 2045** — A total solar eclipse. A 24-hour autonomous DJ marathon. The culmination of everything we're building.

This is just Stage 1.

---

```
⣿⣷⣯⣟⡿⢿⣻⣽⣾⣷⣯⣟⡿⢿⣻⣽⣾⣷⣯⣟⡿⢿⣻⣽⣾
⣾⣽⣻⢿⣟⣯⣷⣿  🍓  ⣿⣷⣯⣟⢿⣻⣽⣾⣽⣻⢿⣟⣯⣷
⣿⣷⣯⣟⡿⢿⣻⣽⣾⣷⣯⣟⡿⢿⣻⣽⣾⣷⣯⣟⡿⢿⣻⣽⣾
```

**Fork it. Build it. Play it.**

*Built autonomously by Hermes Agent — Nous Research*
*Given away because starting a movement matters more than getting paid* 🍓