A battery-packed AI chatbot built with Next.js 15 and AI SDK 5. Easy deployment on Cloudflare Workers. Free, open-source, and designed for the AI revolution in Africa.
Mobile responsive and frictionless scrolling on any device. Screenshots for reference only - final output depends on browser zoom and device settings.
More screenshots available for Galaxy S21 Ultra, Xiaomi 12, Google Pixel 6 Pro in public/images/.
- Screenshots
- Features
- Demo
- Quick Start
- Installation
- Tech Stack
- Usage
- Contributing
- License
- Contact
- About
- Resources
- Why Star This Repo?
- ✅ Mobile Responsive: Seamless experience across all devices
- ✅ Free & Open Source: MIT licensed, community-driven
- ✅ Modern UI/UX: Built with Assistant-UI and Shadcn/UI
- ✅ Instant Deployment: One-command deploy to Cloudflare Workers
- ✅ Light/Dark Mode: Automatic theme switching
- ✅ Cloud Storage: Assistant-UI cloud storage (200 MAU free, see env.example for setup)
- ✅ Multi-Provider Support: Choose from OpenAI, Anthropic, Azure, AWS, GCP, Groq, Fireworks, Cohere, Ollama, Chrome AI
- ✅ Web Search: Integrated web search capabilities
- ✅ Audio Responses: Listen to AI responses with client-side text-to-speech (first time activation may take a few minutes)
- 🔄 Coming Soon: Image Generation, Auth, R2 Storage, MCP, RAG
Experience the live demo: chat.bull.africa
Get up and running in minutes:
# Clone the repository
git clone https://github.com/dreemrworld/chat.bull.africa.git
cd chat.bull.africa
# Install dependencies
pnpm install
# Set up environment (copy and configure)
cp env.example .env
# Run locally
pnpm run devOpen http://localhost:3000 and start chatting!
- Node.js 18+
- pnpm (recommended) or npm/yarn
- Cloudflare account (for deployment)
-
Clone & Install
git clone https://github.com/dreemrworld/chat.bull.africa.git cd chat.bull.africa pnpm install -
Configure Environment
cp env.example .env # Edit .env with your API keys (Gemini recommended for free tier) -
Switch AI Providers (Optional)
- Follow Assistant-UI instructions
- Supports: OpenAI, Anthropic, Azure, AWS, GCP, Groq, Fireworks, Cohere, Ollama, Chrome AI
-
Deploy to Cloudflare
pnpm run deploy
That's it! Your AI chatbot is now live in 300+ locations worldwide.
Built with modern, battle-tested technologies:
- Frontend: Next.js 15, React, TypeScript
- UI/UX: Assistant-UI, Shadcn/UI, Radix UI, Tailwind CSS
- AI: AI SDK 5, Google Gemini API
- Deployment: Cloudflare Workers, OpenNext (done for you)
- Storage: Assistant-UI cloud (200 MAU free) you may change ofcourse
pnpm run devpnpm run deploy- Modify
app/page.tsxfor UI changes - Update
app/api/chat/route.tsfor AI logic - Customize themes in
components/theme-provider.tsx
We welcome contributions! This project is built for the open-source community.
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'Add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request
- Follow existing code style
- Add tests for new features
- Update documentation
- Ensure mobile responsiveness
This project is licensed under the MIT License - see the LICENSE file for details.
- Email: carlos@goat.africa
- Twitter: @dreemrworld
- Website: dev.goat.africa
Carlos Araújo - Full-stack developer passionate about AI and African innovation.
"I subscribe to Garry Kasparov's vision in Deep Thinking: Where Machine Intelligence Ends and Human Creativity Begins. I'm bullish on Artificial Intelligence in Africa because I'm bullish on African Intelligence."
My programming journey began just 10 months ago, accelerated by AI tools like DeepSeek, Qwen 3 Coder, Kimi, and Gemini. I want everyone to become a VICTOR of the AI revolution, not just a victim.
- Assistant-UI Documentation
- Free LLM API Resources
- Deep Thinking | Garry Kasparov | Talks at Google
- Cloudflare Workers
- Live Demo
- My First AI Project
- Dev Profile
Don't star it just because it's free, open-source, and modern. Star it so more people can discover, use, and benefit from AI!
- 🚀 Save Time & Money: Instant deployment, no complex setup
- 🌍 Global Reach: 300+ Cloudflare locations
- 🤝 Community-Driven: Help build the future of AI in Africa
- 🎯 Easy to Customize: Switch AI providers, add features
- 📈 Learn & Grow: Perfect for developers entering the AI space
May the yield be with you! 🌟
Built with ❤️ for the open-source community. Clone, fork, contribute - let's build the AI future together!
Special thanks to:
- Assistant-UI for the amazing starter template
- Google for generous Gemini API free tier
- Cloudflare for making global deployment accessible
- The open-source community for inspiration and support
README crafted with StackEdit and screenshots from Mobile Responsive Simulator