xpltdco/fractafrag
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Self-hosted GLSL shader platform
12 commits 1 branch 0 tags 208 KiB
Find a file
John Lightner e462c7c452 chore: gitignore Claude Code, GSD, and planning directories 
Remove .claude/, .bg-shell/, .gsd/, .planning/, and CLAUDE.md
from git tracking. These are local tooling configs that should
not be in the repo.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-25 11:36:58 -05:00
db Versioning, drafts, resizable editor, My Shaders, 200 seed shaders 2026-03-24 22:00:10 -05:00
scripts Fix shader rendering: visibility-aware WebGL contexts, fix 2 GLSL shaders 2026-03-24 22:12:58 -05:00
services feat(M001): Desire Economy 2026-03-25 02:22:50 -05:00
.env.example M0: Foundation scaffold — Docker Compose, DB schema, FastAPI app, all service stubs 2026-03-24 20:45:08 -05:00
.gitignore chore: gitignore Claude Code, GSD, and planning directories 2026-03-25 11:36:58 -05:00
docker-compose.dev.yml Fix Docker Compose startup issues 2026-03-24 21:06:01 -05:00
docker-compose.override.yml Fix Docker Compose startup issues 2026-03-24 21:06:01 -05:00
docker-compose.yml Fix Docker Compose startup issues 2026-03-24 21:06:01 -05:00
FRACTAFRAG FULL SPEC & SUMMARY.md Initial commit: project spec 2026-03-24 20:36:53 -05:00
Makefile feat(M001): Desire Economy 2026-03-25 02:22:50 -05:00
README.md M0: Foundation scaffold — Docker Compose, DB schema, FastAPI app, all service stubs 2026-03-24 20:45:08 -05:00

README.md

🔥 Fractafrag

A self-hosted GLSL shader platform — browse, create, generate, and share real-time GPU visuals.

Fractafrag fuses three experiences:

  • TikTok-style adaptive feed of living, animated shaders that learns your taste
  • Shadertoy-style code editor for writing, forking, and publishing GLSL shaders
  • AI generation layer where you describe what you want and the platform writes the shader

Plus a desire queue / bounty board where users express what they want to see, and human creators or AI agents fulfill those requests.

Quick Start

# 1. Clone and configure
cp .env.example .env
# Edit .env with your secrets

# 2. Launch everything
docker compose up -d

# 3. Open
open http://localhost

Architecture

nginx (reverse proxy)
├── /         → React frontend (Vite)
├── /api/*    → FastAPI backend
└── /mcp/*    → MCP server (AI agent interface)

postgres (pgvector/pgvector:pg16) — primary datastore + vector similarity
redis (redis:7-alpine) — cache, rate limiting, job queue
renderer — headless Chromium shader renderer
worker — Celery job processor (render, embed, AI generate)

Tech Stack

Layer Tech
Frontend React 18, Vite, Three.js, TanStack Query, Zustand, Tailwind CSS
Backend Python, FastAPI, SQLAlchemy, Pydantic
Database PostgreSQL 16 + pgvector, Redis 7
Jobs Celery + Redis
Renderer Node.js + Puppeteer (Headless Chromium)
MCP Python MCP SDK, HTTP+SSE transport
Payments Stripe (subscriptions + Connect)
Container Docker Compose, single-stack

Milestone Roadmap

Milestone Focus Status
M0 Infrastructure + Auth 🚧 In Progress
M1 Core Shader Loop (editor, submit, feed) ⏳
M2 Intelligence Layer (MCP, recommendations) ⏳
M3 Desire Economy (bounties, fulfillment) ⏳
M4 Monetization (Stripe, subscriptions) ⏳
M5 AI Generation (prompt → shader) ⏳

Development

# API direct access (dev mode)
http://localhost:8000/api/docs   # Swagger UI
http://localhost:8000/health     # Health check

# Services
http://localhost:5173   # Vite dev server
http://localhost:3200   # MCP server
http://localhost:3100   # Renderer

License

Private — see DECISIONS.md for project governance.