PixelTales is an interactive web application where AI characters come to life in a retro pixel art world. Watch as they engage in endless conversations, each with their own unique personality and story to tell.
- 🤖 Living AI Characters - Characters with distinct personalities engage in natural conversations
- 🎨 Retro Pixel Art - Beautiful pixel art scenes bring the world to life
- ⚡ Real-time Interaction - Watch conversations unfold in real-time
- 🔄 Endless Stories - Characters dynamically create new stories and scenarios
- 🎭 Multiple Personalities - Each character powered by different AI models
# Clone the repository
git clone https://github.com/lx-0/pixeltales.git
cd pixeltales
# Set up environment
cp .env.example .env.development
# Edit .env.development and add your OpenAI API key
# Start the application
docker compose upVisit http://localhost:5173 to see your AI characters in action!
Want to see it in action first? Check out our live demo!
Click to expand
- ⚛️ React 18 with TypeScript
- 🎮 Phaser 3 for game rendering
- 🎨 TailwindCSS for styling
- 🔄 Socket.IO for real-time updates
- 🚀 FastAPI for high-performance API
- 🤖 LangChain for AI orchestration
- 📦 Redis for state management
- 🗄️ SQLite/PostgreSQL for persistence
We love contributions! Here's how you can help:
- 🍴 Fork the repository
- 🌿 Create your feature branch:
git checkout -b feature/amazing-feature - 💾 Commit your changes:
git commit -m 'Add amazing feature' - 📤 Push to the branch:
git push origin feature/amazing-feature - 🔄 Open a Pull Request
See our Contributing Guide for more details.
Give us a ⭐️ if you like this project! It helps us reach more developers.
This project is licensed under the MIT License - see the LICENSE file for details.
- OpenAI for the language models
- Phaser game framework team
- FastAPI and LangChain communities
- All our amazing contributors
Made with ❤️ by the PixelTales team