Rhizome / Skein

Decentralized rhizomatic social networking with cultural knowledge integration

---

🚀 Quick Start

Prerequisites

• Python 3.12+
• PostgreSQL 14+
• Docker & Docker Compose (recommended)
• Git

Development Setup

1. Clone the repository
   bash git clone https://github.com/jason-akashic/skein.git cd skein

2. Set up environment variables
   bash cp .env.example .env.dev # Edit .env.dev with your configuration

3. Start development environment
   bash docker-compose -f docker-compose.dev.yml up -d

4. Run database migrations
   bash docker exec -it dev-rhizome-1 flask db upgrade

5. Create initial user (optional)
   ```bash
   docker exec -it dev-rhizome-1 flask shell
   # In shell:

   from rhizome_app.models import User
   from rhizome_app.extensions import db
   user = User(username='admin', email='admin@example.com')
   user.set_password('password')
   db.session.add(user)
   db.session.commit()
   ```

6. Access the application

7. Web UI: http://localhost:5000
8. Health check: http://localhost:5000/health

Production Setup

See docs/deployment/ for production deployment instructions.

---

📚 Documentation

For Developers

• Tech Stack - Cutting-edge technologies (JSONB, RDF, Event Sourcing, etc.)
• Architecture Overview - High-level system architecture
• Sneakerware Foundation - Event-sourced, offline-first architecture
• Akashic Protocol - Universal protocol layer
• Rhizomatic Threading - Multi-dimensional conversations

For Contributors

• North Star - Project vision and practices
• Git Protocol - Git workflow standards

Philosophy & Vision

• Rhizome Philosophy - Core principles and vision
• Akashic Skein Manifesto - Foundational manifesto

---

🏗️ Project Structure

skein/
├── rhizome_app/          # Main Flask application
│   ├── blueprints/       # Route modules
│   ├── models/          # Database models
│   ├── services/        # Business logic
│   └── templates/       # Jinja2 templates
├── docs/                # Documentation
│   ├── architecture/    # System architecture docs
│   ├── implementation_plans/  # Feature design docs
│   └── deployment/      # Deployment guides
├── north_star/          # Vision, manifestos, practices
│   ├── manifestos/     # Philosophical foundations
│   └── praxis/         # Development practices
├── scripts/            # Utility scripts
└── migrations/         # Database migrations

---

🧪 Testing

# Run tests
docker exec -it dev-rhizome-1 pytest

# Run with coverage
docker exec -it dev-rhizome-1 pytest --cov=rhizome_app

---

🔧 Key Features

Core Architecture

• Event-Sourced: Immutable, append-only event log with cryptographic signatures
• Offline-First: Sneakerware support for USB/mesh network data transfer
• Multi-Protocol: Akashic Protocol as superset, ActivityPub/Nostr/RSS support
• Semantic Web: RDF triplets, canonical URIs, taxonomic organization

Social Features

• Rhizomatic Threading: Multi-reference, non-hierarchical conversations
• ActivityPub Federation: Interoperable with Mastodon, Pleroma, etc.
• Cultural Integration: Books, movies, music, art as first-class entities

---

🤝 Contributing

We welcome contributions! Please see:

1. Git Protocol - Commit standards
2. Code Style - Coding conventions
3. Open an Issue to discuss your contribution

---

📖 Philosophy

Rhizome is built on principles of decentralization, semantic richness, and cultural preservation. We believe:

• No Mountaintop Authorities: Truth emerges from collective intelligence
• Canonical Cultural Objects: Every work gets a unique, persistent identity
• Rhizomatic Connections: Any node can connect to any other, no hierarchy
• Offline Resilience: Works without internet, propagates through physical connections

Read more in Rhizome Philosophy.

---

📄 License

MIT License - see LICENSE file for details.

---

🔗 Links

• Web: dev.akashicindustries.com
• Issues: GitHub Issues
• Discussions: GitHub Discussions (if enabled)

---

Built with ❤️ by Akashic Industries

← Back to Splash