AI-powered site generator that actually works in production

Stop wasting time debugging broken layouts. Trinity generates beautiful, responsive websites from any data using AI—and automatically fixes any CSS issues before deployment.

🚀 Quick Start • ✨ Features • 🎯 Why Trinity? • 📚 Examples • 📖 Documentation

# Install
pip install -r requirements.txt

# Generate your portfolio
python main.py --input data/input_content.json --theme brutalist --output portfolio.html

# That's it! Open portfolio.html in your browser

What just happened?

1. ✅ Trinity analyzed your GitHub repos
2. ✅ AI generated compelling content
3. ✅ Applied a professional theme
4. ✅ Automatically fixed any layout issues
5. ✅ Output validated, production-ready HTML

# Clone and start
git clone https://github.com/fabriziosalmi/trinity.git
cd trinity
./dev.sh start

# Build inside container
docker-compose exec trinity-builder trinity build --theme brutalist

• Local LLM Support: Ollama, LlamaCPP, LM Studio
• Cloud LLMs: OpenAI, Claude, Gemini (via API)
• Smart Caching: 40% cost reduction on repeated builds
• Async Operations: 6x faster with concurrent requests

• 14 Built-in Themes: Enterprise, Brutalist, Editorial, Minimalist, Hacker, and more
• Tailwind CSS: Modern, responsive design out of the box
• Dark Mode: Auto-switching based on user preference
• Customizable: YAML configuration for easy theming

• Automatic CSS Fixes: Detects and repairs overflow, broken grids, text wrapping
• ML-Powered: Random Forest multiclass predictor recommends optimal strategy
• Progressive Strategies: 4 healing strategies (CSS_BREAK_WORD → FONT_SHRINK → CSS_TRUNCATE → CONTENT_CUT)
• Visual Validation: Guardian DOM-based validation system

• Circuit Breakers: Graceful degradation on LLM failures
• Idempotency: Same input = same output (deterministic builds)
• Structured Logging: JSON logs ready for ELK/Datadog/CloudWatch (stdout in Production)
• Immutable Config: Type-safe, validated settings

# From GitHub repos to portfolio in one command
python main.py --input data/portfolio.txt --theme enterprise

Output: Professional portfolio with:

• Hero section with AI-generated tagline
• Project cards with descriptions
• Tech stack badges
• Responsive grid layout
• Dark mode support

# Generate blog landing page
python main.py --input blog_posts.json --theme editorial

Features:

• Clean, readable typography
• Featured post highlighting
• Category organization
• Mobile-first design

# Technical documentation site
python main.py --input api_docs.json --theme minimalist

Optimized for:

• Code snippet display
• API reference layout
• Search-friendly structure
• Fast load times

Input → Brain (LLM) → Skeleton (Theme) → Healer (CSS Fixes) → Output
         ↓                                      ↑
      Caching                            Predictor (ML)
         ↓                                      ↑
    Structured Logging              Guardian (Visual QA)

Phase 6 Improvements (v0.7.0):

Features:

• ✅ Async/await with HTTP/2 multiplexing
• ✅ Multi-tier caching (memory → Redis → filesystem)
• ✅ Structured logging for aggregation
• ✅ Makefile shortcuts (make test, make build)

# Professional
--theme enterprise      # Corporate, clean, trustworthy
--theme minimalist      # Simple, elegant, focused

# Creative
--theme brutalist       # Bold, raw, attention-grabbing
--theme editorial       # Magazine-style, readable

# Technical
--theme hacker          # Terminal-inspired, monospace
--theme tech_01         # Modern tech aesthetic

# And 8 more...

Preview all themes: python main.py --list-themes

# Use local LLM (recommended)
export LLM_PROVIDER=ollama
export LLM_MODEL=qwen2.5-coder:7b

# Or cloud LLMs
export OPENAI_API_KEY=your_key
export LLM_PROVIDER=openai

# Production Telemetry
export TRINITY_ENV=Production  # Enable JSON logs to stdout

# config/settings.yaml
llm:
  provider: ollama
  model: qwen2.5-coder:7b
  temperature: 0.2
  cache_enabled: true
  cache_ttl: 3600

themes:
  default: brutalist
  dark_mode: auto

healer:
  enable_neural: true
  max_attempts: 3
  strategies:
    - CSS_BREAK_WORD
    - FONT_SHRINK
    - CSS_TRUNCATE

See Configuration Guide for all options.

• Installation Guide - Detailed setup instructions
• Quick Start Tutorial - Your first portfolio in 5 minutes
• CLI Reference - Complete command documentation

• Async Guide - Async/await migration and performance
• Caching Guide - Multi-tier cache configuration
• Logging Guide - Structured logging and observability
• Makefile Guide - Development workflow shortcuts

• Architecture Overview - System design and components
• Neural Healer - ML-powered CSS fixing
• Theme Development - Creating custom themes
• Security Policy - Vulnerability reporting

• Contributing Guide - Development setup and guidelines
• Changelog - Version history and release notes
• Phase 6 Roadmap - Future features and improvements

# Run all tests
make test

# With coverage
make test-cov

# E2E tests (complete workflow)
pytest tests/test_e2e_complete.py -v

# Multiclass pipeline tests
pytest tests/test_multiclass_pipeline.py -v

# Docker E2E validation
./scripts/test_docker_e2e.sh

Test Coverage: 111/111 tests passing (24 E2E + multiclass, 32 healer, 6 engine, 49 other)

# Build image
make docker-build

# Run container
make docker-run

# Development mode with live reload
make docker-dev

See Docker Guide for production deployment.

We welcome contributions! Here's how to get started:

# 1. Fork and clone
git clone https://github.com/fabriziosalmi/trinity.git
cd trinity

# 2. Setup development environment
make setup

# 3. Create feature branch
git checkout -b feature/amazing-feature

# 4. Make changes and test
make test
make format
make lint

# 5. Commit and push
git commit -m "feat: add amazing feature"
git push origin feature/amazing-feature

# 6. Open Pull Request

See CONTRIBUTING.md for detailed guidelines.

MIT License - see LICENSE for details.

• LLM Providers: Ollama, OpenAI, Anthropic, Google
• Frameworks: Jinja2, Tailwind CSS, PyTorch
• Tools: Playwright, Pydantic, httpx
• Community: All contributors and users

• Version: 0.8.1
• Python: 3.10+
• Tests: 111/111 passing (9 E2E, 15 multiclass, 32 healer, 6 engine, 49 other)
• Themes: 14 built-in + Centuria Factory for mass generation
• Self-Healing: 4 progressive strategies with ML prediction
• Coverage: Comprehensive E2E + Docker validation

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Security: SECURITY.md

Made with ❤️ by @fabriziosalmi

Generate beautiful portfolios. Let AI do the heavy lifting.