Upload your art. Let AI handle the rest. Pay nothing.
A production-ready AI art gallery and blog. 9 dependencies. Zero vendor lock-in. Runs entirely on Cloudflare's free tier.
Important
No coding required. Fork the repo, follow the Deployment Guide, and have your site live in minutes. Or use bash setup.sh for a one-command deploy.
- Gallery — Upload artwork, AI auto-tags and describes it using vision models
- Blog — Markdown editor with AI copywriting assistance
- Multi-LLM orchestration — Switch between Cloudflare Workers AI, NVIDIA NIM, and Google Gemini from the dashboard. No middleware, no SDKs — direct API calls routed by string prefix
- Butler — Context-aware AI assistant that knows your site's content and state
- Admin panel — Full CMS with site config, AI settings, content audit, usage monitoring
- Agentic development — Ships with
.claude/and.antigravity/context files so AI coding tools understand the project from the first prompt
graph LR
A([Fork]) --> B([API Key])
B --> C([Deploy to CF])
C --> D([Upload Art])
D --> E{AI Agent}
E -->|Auto-tag| F[(D1 Database)]
E -->|Store| G[(R2 Storage)]
F & G --> H([Live Portfolio])
style A fill:#6ee7b7,stroke:#059669,color:#000
style B fill:#fcd34d,stroke:#d97706,color:#000
style C fill:#93c5fd,stroke:#2563eb,color:#000
style D fill:#c4b5fd,stroke:#7c3aed,color:#000
style E fill:#f97316,stroke:#c2410c,color:#fff
style F fill:#e2e8f0,stroke:#64748b,color:#000
style G fill:#e2e8f0,stroke:#64748b,color:#000
style H fill:#34d399,stroke:#059669,color:#000
Layer 1: Deploy with AI (zero code)
Fork → paste the prompt from DEPLOY_WITH_AI.md into Claude Code or Antigravity → your site is live.
Layer 2: Customize via Admin Panel
- Switch AI providers and models from the dashboard
- Edit system prompts to change how AI describes your art
- Configure hero, navigation, metadata
- Protect
/adminwith Cloudflare Zero Trust
See SETUP.md for full configuration guide.
Layer 3: Build with AI Coding Tools
This repo ships with agentic context files:
.claude/CLAUDE.md— Runclaudein the root. The agent understands the architecture, constraints, and patterns instantly..antigravity/rules.md— Gemini and other AI tools read this for project context.
Adding a new AI provider is ~80 lines. Adding a new admin page follows established patterns. The codebase is intentionally readable — 200-line file cap, zero React, pure Astro components.
| Layer | Technology |
|---|---|
| Framework | Astro 6 (SSR) |
| Runtime | Cloudflare Workers (edge) |
| Database | Cloudflare D1 (serverless SQLite) |
| Storage | Cloudflare R2 (S3-compatible) |
| AI | CF Workers AI + NVIDIA NIM + Google Gemini |
| Styling | Tailwind CSS 4.2.2 |
| Dependencies | 9 total (zero React, zero ORMs, zero AI SDKs) |
- Astro 6 with
@astrojs/cloudflarev13 (vite-based build,cloudflare:workersenv) - Gallery with masonry layout, tag/model filtering via URL params
- Markdown blog with topics and RSS
- Multi-provider AI: vision analysis, text generation, chat
- Butler chatbot with site context injection
- Admin panel: gallery, blog, pages, AI settings, audit, developer hub
- Smart onboarding checklist (detects actual DB state)
setup.shone-command deploy- GitHub Actions CI (auto-deploys when credentials configured)
llms.txtfor AI discoverability
# Clone your fork
git clone https://github.com/YOUR_USERNAME/AIGC-portfolio.git
cd AIGC-portfolio
# Automated setup (creates D1, R2, deploys)
bash setup.sh
# Or manual
npm install
npm run dev # local development
npm run deploy # build + deploy to CloudflareSee SETUP.md for detailed instructions or how-to-get-free-test-api.md for API key guides.
Note
Responsible AI Usage: Free-tier keys are sufficient for testing and personal use. For production, consider paid API tiers for reliability.
Regional Compliance: AI regulations (EU AI Act, China's Generative AI Measures, Canada's AIDA) vary by region. As the operator of your fork, you are responsible for transparency, data privacy, and usage accountability.
MIT License — See LICENSE for details.
Built with AI agents for the next generation of creators.