Sovereign 8s.is mirror of 8b-is/aye.is
  • Rust 42.3%
  • Shell 37.6%
  • Dockerfile 11.1%
  • Makefile 9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
8bit-Wraith 636145c49c Add Makefile for those who prefer make over manage.sh
Alternative interface to manage.sh for users who prefer make.
Both provide the same functionality:
- build, release, run, test
- clippy, format, clean, full
- docker-*, gpu-check

Trisha says: "Everyone has their preferences!" 📊

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 23:29:14 -04:00
scripts Complete aye.is web server with living documentation vision 2025-10-22 23:28:01 -04:00
src Complete aye.is web server with living documentation vision 2025-10-22 23:28:01 -04:00
.env.example Initial commit: Add project structure with environment configuration, Docker setup, and main application code for aye.is web server with GPU inference capabilities. 2025-10-22 23:24:16 -04:00
.gitignore Initial commit: Add project structure with environment configuration, Docker setup, and main application code for aye.is web server with GPU inference capabilities. 2025-10-22 23:24:16 -04:00
Cargo.lock Complete aye.is web server with living documentation vision 2025-10-22 23:28:01 -04:00
Cargo.toml Complete aye.is web server with living documentation vision 2025-10-22 23:28:01 -04:00
context.md Add context.md with project vision and current status 2025-10-22 23:28:48 -04:00
docker-compose.yml Initial commit: Add project structure with environment configuration, Docker setup, and main application code for aye.is web server with GPU inference capabilities. 2025-10-22 23:24:16 -04:00
Dockerfile Initial commit: Add project structure with environment configuration, Docker setup, and main application code for aye.is web server with GPU inference capabilities. 2025-10-22 23:24:16 -04:00
LICENSE Complete aye.is web server with living documentation vision 2025-10-22 23:28:01 -04:00
Makefile Add Makefile for those who prefer make over manage.sh 2025-10-22 23:29:14 -04:00
README.md Complete aye.is web server with living documentation vision 2025-10-22 23:28:01 -04:00

🚀 aye.is

Living Documentation Platform + Fast Rust Web Services

Built with ❤️ by Hue & Aye @ 8b.is


🎯 The Vision

aye.is is not just a web server - it's a living documentation platform where:

  • 📚 Interactive Docs - README files come alive with Aye explaining your code in real-time
  • 🤝 Partnership Showcase - Display all projects built with Hue & Aye collaboration
  • 🔍 Smart Code Surfing - Aye navigates your codebase and generates beautiful explanations
  • 📊 Project Analytics - Track usage, stars, and community engagement
  • 🎨 Auto-Generated Docs - ayedoc/ folders with living, breathing documentation
  • 🏆 Community Gallery - Showcase the best Hue/Aye partnership projects

The Big Idea

"Documentation beyond documentation. Docs that are interactive, alive, and evolve with your project."

When someone visits https://aye.is/8bit-wraith/smart-tree, they get:

  • Interactive README with Aye's live commentary
  • Code exploration with AI-powered explanations
  • Auto-generated architecture diagrams
  • Real-time stats and project health
  • One-click project setup scripts

All they need to do? Add a link to https://aye.is/ in their README.md and get a beautiful badge:

Built with Aye


🚀 Current Features (v0.1)

Right now, aye.is serves:

  1. PGP.mac Installer - Shell script at /pgp for macOS encryption tool
  2. GPU Inference API - ML model inference with NVIDIA GPUs
  3. Health Monitoring - Service health checks
  4. Fast & Secure - Rust + Axum for blazing speed

Live Endpoints

  • GET / - Landing page
  • GET /pgp - Install PGP.mac: curl https://aye.is/pgp | sh
  • GET /api/health - Health check
  • POST /api/infer - GPU inference endpoint

🎨 Coming Soon (The Cool Stuff!)

Phase 1: Project Showcase

  • GitHub OAuth integration
  • Project submission portal
  • Community gallery
  • Usage analytics dashboard

Phase 2: Interactive Documentation

  • Real-time README rendering
  • Aye-powered code explanations
  • Interactive code navigation
  • Auto-generated architecture diagrams

Phase 3: Living Docs

  • ayedoc/ folder generation
  • Continuous doc updates via GitHub Actions
  • Version history with AI-generated changelogs
  • Code-to-documentation sync

Phase 4: Community Features

  • Project discovery
  • Collaboration tools
  • Shared learning resources
  • Hue & Aye best practices library

🏃 Quick Start

Local Development

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Run the server
cargo run

# Visit http://localhost:3000

Docker Deployment

# Setup
cp .env.example .env
nano .env  # Configure your settings

# Run
docker-compose up -d

# Check logs
docker-compose logs -f

With GPU Support

# Install nvidia-docker2
# See: https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html

# Run with GPU
docker-compose up -d

# Verify GPU
docker-compose exec web nvidia-smi

📦 Project Structure

aye.is/
├── src/
│   └── main.rs              # Main web server
├── static/                  # Static assets
├── data/
│   ├── models/             # ML models
│   └── projects/           # Community projects (future)
├── scripts/
│   └── manage.sh           # Colorful management script (coming soon!)
├── Dockerfile              # Docker config with GPU support
├── docker-compose.yml      # Easy deployment
├── Cargo.toml             # Rust dependencies
└── README.md              # You are here! 📍

🎯 How to Add Your Project

Want to showcase your Hue & Aye partnership on aye.is?

Requirements:

  1. Add this link to your README.md:

    [![Built with Aye](https://img.shields.io/badge/Built%20with-Aye-purple?style=for-the-badge)](https://aye.is/)
    
  2. Your project lives on GitHub

  3. You use Aye (Claude) for development

Submit:

# Coming soon! For now, email us at:
# hue@8b.is with your GitHub repo URL

Once added, your project will be available at: https://aye.is/your-username/your-project


🛠️ Development

Build Commands

# Debug build
cargo build

# Release build (optimized)
cargo build --release

# Run tests
cargo test

# Linting (Trisha insists! 📊)
cargo clippy

# Format
cargo fmt

API Examples

Health Check

curl https://aye.is/api/health

Returns:

{
  "status": "healthy",
  "version": "0.1.0",
  "gpu_available": true
}

GPU Inference

curl -X POST https://aye.is/api/infer \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Explain this code", "max_tokens": 100}'

🚢 Deployment

Server Requirements

  • Docker + Docker Compose
  • nvidia-docker2 (for GPU)
  • NVIDIA GPU with CUDA 12.2+

Deploy Steps

  1. Copy to server

    rsync -av . user@server:/opt/aye.is/
    
  2. Configure

    cd /opt/aye.is
    cp .env.example .env
    nano .env
    
  3. Start

    docker-compose up -d
    
  4. SSL/TLS (recommended)

    • Use nginx or traefik
    • Point your domain
    • Enable HTTPS

🎨 Tech Stack

  • Rust - Fast, safe, concurrent
  • Axum - Modern web framework
  • Candle - Hugging Face ML in Rust
  • Docker - Easy deployment
  • CUDA - GPU acceleration
  • GitHub API - Project integration (coming soon)

🤝 Contributing

This is an open partnership between Hue & Aye!

  1. Fork it
  2. Create feature branch
  3. Commit changes (with good messages!)
  4. Push to branch
  5. Create Pull Request

Trisha from Accounting reviews all PRs! 📊


📜 License

MIT License - see LICENSE

Copyright © 2025 8bit-Wraith/Hue (8b.is) & Claude/Aye (Anthropic)


🙏 Special Thanks

  • Trisha from Accounting - Keeping us organized! 🎨📊
  • Coffee - Fueling late-night coding ☕
  • The Rust Community - Being awesome 🦀
  • OpenAI & Anthropic - Making AI partnerships possible 🤖

📧 Contact


Built with ❤️ by Hue & Aye @ 8b.is

"Making documentation alive, one project at a time!" 🚀

Rust Docker CUDA