A cute AI chat assistant as a Farcaster Mini App~ ✨

Chat with Misa, a friendly AI girl who loves anime, cute things, and the Farcaster community!

• 💕 Cute AI personality based on @xqc's style
• 🎀 Animated avatar with lip sync
• ✨ Cyberpunk terminal UI
• 📱 Farcaster Mini App compatible
• 🔥 Powered by Gemini AI

• Node.js 22+
• Python 3.10+ (for backend server)
• Gemini API Key

npm install

1. Start the backend server (from avatar-ui/server):

cd ../avatar-ui/server
.venv\Scripts\activate
python -m uvicorn main:app --reload

2. Start the frontend:

npm run dev

Or run both together:

npm run dev:all

npm run build

1. Deploy to Vercel or similar hosting
2. Update URLs in:
   • src/index.html (fc:miniapp meta tag)
   • public/.well-known/farcaster.json
3. Sign the manifest at: https://farcaster.xyz/~/developers/mini-apps/manifest
4. Update farcaster.json with signed accountAssociation

MIT