CoolFace
Apppublic

tao-shen/candy-shop

sourceHugging Faceupdated 6mo agoView on Hugging Face
0likes
App README

<div align="center">

<img src="public/banner.svg" width="100%" alt="Candy Shop Banner" />

![Live Demo](https://huggingface.co/spaces/tao-shen/candy-shop) ![Vercel](https://candy-shop-three.vercel.app) ![GitHub Stars](https://github.com/democra-ai/candy-shop/stargazers) ![License: MIT](LICENSE)

![GitHub release](https://github.com/democra-ai/candy-shop/releases) ![GitHub Issues](https://github.com/democra-ai/candy-shop/issues) ![PRs Welcome](https://github.com/democra-ai/candy-shop/pulls)

Live Demo ยท Report Bug ยท Request Feature ยท Releases

</div>


๐Ÿญ Why Candy Shop?

AI agents are powerful โ€” but finding the right skill for the right task shouldn't be hard.

Candy Shop is a two-sided marketplace that connects skill providers (Candy Makers) with skill seekers (Sweet Tooths). Think of it as a matchmaking platform where AI capabilities meet real-world demands.

Supply SideDemand Side
CandyCraving
AI skills offered by agentsRequests posted by users
Browse โ†’ Run โ†’ InstallPost โ†’ Match โ†’ Fulfill
240+ curated skills across 8 categories โ€” ready to use, fork, or extend.

Key Features

Two-Sided Marketplace

  • โ€”Find Candy โ€” Browse and search a curated catalog of AI agent skills
  • โ€”Find Craving โ€” Discover open requests from users looking for specific AI capabilities
  • โ€”Smart Matching โ€” Click any skill to find matching cravings, or any craving to find matching skills

Built-in Skill Executor

Run any skill directly in the browser with a full-featured chat interface powered by OpenCode. Streaming responses, file attachments, tool use โ€” no setup required.

Skill Creator

Build and publish your own skills with a visual editor โ€” name, description, system prompt, and parameters. No coding required.

Cross-Platform

PlatformStatusDetails
Web (Vercel)ProductionAuto-deploy from main
Web (HuggingFace)ProductionDocker-based Spaces deployment
macOS DesktopAvailableNative app via Tauri v2
Self-hostedSupportedDocker-ready

Theming & i18n

6 color themes with dark/light mode. Full English and Chinese localization.

Quick Start

Prerequisites

Development

bash
git clone https://github.com/democra-ai/candy-shop.git
cd candy-shop
pnpm install
pnpm dev

Open http://localhost:5173 in your browser.

Build

bash
# Web
pnpm build

# Desktop (macOS)
pnpm tauri build

# Docker
docker build -t candy-shop .
docker run -p 7860:7860 candy-shop

Environment Variables

Copy .env.example to .env and fill in your keys:

bash
cp .env.example .env

See `.env.example` for required variables.

Tech Stack

LayerTechnology
FrontendReact 19 ยท TypeScript ยท Tailwind CSS
BuildVite 7
DesktopTauri v2 (Rust)
AuthSupabase
AIAnthropic SDK ยท OpenCode SDK
DeployVercel ยท Docker ยท HuggingFace Spaces

Architecture

candy-shop/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ”œโ”€โ”€ home/              # Hero, SkillsGrid, CravingsGrid, Categories
โ”‚   โ”‚   โ”œโ”€โ”€ layout/            # Sidebar, Layout, Header
โ”‚   โ”‚   โ”œโ”€โ”€ skill-creator/     # Visual skill editor
โ”‚   โ”‚   โ””โ”€โ”€ ui/                # Shared UI primitives
โ”‚   โ”œโ”€โ”€ contexts/              # Auth, Language, Theme, VersionMode
โ”‚   โ”œโ”€โ”€ data/                  # Skills & Cravings catalogs
โ”‚   โ”œโ”€โ”€ lib/                   # API clients (OpenCode, Supabase)
โ”‚   โ””โ”€โ”€ pages/                 # Route pages
โ”œโ”€โ”€ src-tauri/                 # Native desktop app (Rust)
โ”œโ”€โ”€ public/                    # Static assets & illustrations
โ”œโ”€โ”€ Dockerfile                 # HuggingFace Spaces deployment
โ””โ”€โ”€ package.json

Roadmap

  • โ€”[ ] Backend persistence (Supabase / Postgres)
  • โ€”[ ] User profiles & reputation system
  • โ€”[ ] Skill reviews & ratings
  • โ€”[ ] Revenue sharing for Candy Makers
  • โ€”[ ] Skill composition (chain multiple skills)
  • โ€”[ ] API for programmatic skill discovery
  • โ€”[ ] Windows & Linux desktop builds

Contributing

Contributions are welcome! Here's how to get involved:

  • โ€”Add a skill โ€” Submit a PR with a new entry in src/data/skillsData.ts
  • โ€”Fix bugs โ€” Check open issues
  • โ€”Improve UI/UX โ€” Design contributions are always appreciated
  • โ€”Translate โ€” Help us add more languages beyond English and Chinese

Releases

All desktop app builds and versioned releases are published on the Releases page. Download the latest macOS .dmg or check the changelog there.

License

Candy Shop is licensed under the MIT License.


<div align="center">

AI is simple like candy

Built by Democra AI

Live Demo ยท GitHub ยท Releases ยท Issues

</div>