- Rust 42.3%
- Shell 37.6%
- Dockerfile 11.1%
- Makefile 9%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
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> |
||
| scripts | ||
| src | ||
| .env.example | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| context.md | ||
| docker-compose.yml | ||
| Dockerfile | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
🚀 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:
🚀 Current Features (v0.1)
Right now, aye.is serves:
- PGP.mac Installer - Shell script at
/pgpfor macOS encryption tool - GPU Inference API - ML model inference with NVIDIA GPUs
- Health Monitoring - Service health checks
- Fast & Secure - Rust + Axum for blazing speed
Live Endpoints
GET /- Landing pageGET /pgp- Install PGP.mac:curl https://aye.is/pgp | shGET /api/health- Health checkPOST /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:
-
Add this link to your README.md:
[](https://aye.is/) -
Your project lives on GitHub
-
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
-
Copy to server
rsync -av . user@server:/opt/aye.is/ -
Configure
cd /opt/aye.is cp .env.example .env nano .env -
Start
docker-compose up -d -
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!
- Fork it
- Create feature branch
- Commit changes (with good messages!)
- Push to branch
- 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
- Email: hue@8b.is
- GitHub: 8bit-wraith
- Website: 8b.is