Skip to content

Releases: CooperJiang/PixelPunk

Release list

v1.0.0 - Initial Public Release

v1.0.0 - Initial Public Release Pre-release
Pre-release

Choose a tag to compare

View all tags
@CooperJiang CooperJiang released this 17 Nov 07:11
v1.0.0
12004a6

PixelPunk v1.0.0 - Initial Public Release

We're excited to announce the first public release of PixelPunk - a full-stack intelligent image hosting and resource management platform!

🎉 Highlights

  • AI-Powered Intelligence: Automatic image tagging, classification, and NSFW detection
  • Vector Search: Find similar images using Qdrant-powered semantic search
  • Rich Themes: 12+ carefully curated themes with cyberpunk, fresh, and cute styles
  • Global Ready: Built-in support for Chinese, English, and Japanese
  • Docker Ready: One-command deployment with Docker Compose
  • Developer Friendly: Open API for integration with your applications

✨ Key Features

📸 Multi-Format Upload

  • Support for 10+ image formats
  • Custom watermark overlay
  • Expiration time settings
  • Folder organization
  • Permission control

🤖 AI Automation

  • Auto image classification
  • Intelligent tagging
  • Semantic parsing
  • NSFW content detection
  • Batch processing queue

🧠 Vector Search Engine

  • Image-to-image similarity search
  • Natural language semantic search
  • Smart recommendation system
  • Powered by Qdrant vector database

📁 File Management

  • Unlimited nested folder structure
  • Tag and category system
  • Batch operations
  • Drag & drop interface
  • Custom context menus
  • Favorites quick access

🔗 Flexible Sharing

  • Share folders, images, or mixed content
  • Password protection
  • Expiration dates
  • Album view and batch download
  • Email notifications for access

🔐 Access Control

  • Hotlink protection
  • IP whitelist/blacklist
  • Domain whitelist/blacklist
  • Traffic and bandwidth limits
  • Detailed access statistics

🎨 Beautiful Themes

  • 12+ professionally designed themes
  • Cyberpunk, Fresh, Cute, and more styles
  • Light/Dark mode support
  • Dynamic theme switching
  • Fully customizable

🌍 Internationalization

  • 🇨🇳 Simplified Chinese
  • 🇺🇸 English
  • 🇯🇵 Japanese
  • Dual-style theme support
  • Easy to add new languages

🔧 Developer Tools

  • RESTful API endpoints
  • Upload & random image API
  • Folder binding
  • Access statistics
  • Rate limiting

🚀 Quick Start

One-Click Installation

curl -fsSL http://download.pixelpunk.cc/shell/setup.sh | bash

Docker Deployment

docker pull snine98/pixelpunk:latest
curl -O https://download.pixelpunk.cc/docker/docker-compose.yml
docker-compose up -d

Visit http://localhost:9520 after installation.

💻 System Requirements

Minimum

  • OS: Linux (x86_64/ARM64) / macOS / Windows (WSL2)
  • CPU: 2 cores
  • RAM: 2GB
  • Disk: 10GB

Recommended (Production)

  • CPU: 4+ cores
  • RAM: 4GB+
  • Disk: 50GB+ SSD
  • Network: 100Mbps+ bandwidth

🛠️ Tech Stack

  • Frontend: Vue 3 + TypeScript + Vite + Pinia + TailwindCSS
  • Backend: Go 1.24 + Gin + GORM + JWT
  • Database: SQLite/MySQL + Redis + Qdrant
  • AI: OpenAI API compatible + Embedding models
  • DevOps: Docker + Docker Compose + Systemd

📦 What's Included

This release includes:

  • ✅ Complete source code
  • ✅ Pre-built Docker images
  • ✅ One-click installation script
  • ✅ Comprehensive documentation
  • ✅ Example configurations
  • ✅ Development guides

🔗 Resources

📖 Documentation

🚧 Known Limitations

  • Backend API currently only supports English error messages (multilingual support coming soon)
  • Desktop application is under development
  • Some advanced storage channels are still in beta

🗓️ Roadmap

  • Backend multilingual support
  • UI/UX improvements
  • Desktop client (Electron/Tauri)
  • More storage channel integrations
  • Additional AI model support
  • Mobile app development

🤝 Contributing

We welcome contributions! Whether it's:

  • 🐛 Bug reports
  • 💡 Feature requests
  • 📖 Documentation improvements
  • 💻 Code contributions

See our Contributing Guide for details.

📝 License

This project is licensed under the PolyForm Noncommercial License 1.0.0.

  • ✅ Free for personal use
  • ✅ Free for learning and research
  • ✅ Free for non-commercial purposes
  • ❌ Commercial use requires authorization

See LICENSE for full details.

💖 Acknowledgments

Special thanks to all the open-source projects that made PixelPunk possible:

  • Vue.js, Vite, Pinia, TailwindCSS
  • Go, Gin, GORM
  • Qdrant, Redis, MySQL/SQLite
  • Docker, GitHub Actions
  • And many more...

📧 Support

If you encounter any issues or have questions:

Star ⭐ this repository if you find it useful!

Built with ❤️ by CooperJiang

Loading