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.

Experience the live demo: chat.bull.africa

Built with modern, battle-tested technologies:

• Frontend: Next.js 15, React 19, TypeScript
• UI/UX: Assistant-UI, Shadcn/UI, Radix UI, Tailwind CSS
• AI: AI SDK 5
• Deployment: Cloudflare Workers, OpenNext (done for you)

• ✅ 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
• ✅ 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, R2 Storage, MCP, RAG
• 🔄 In Progress: Authentication, Database - Please check back again soon

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 dev

Open http://localhost:3000 and start chatting!

• Node.js 18+
• pnpm (recommended) or npm/yarn
• Cloudflare account (for deployment)

1. Clone & Install

   git clone https://github.com/dreemrworld/chat.bull.africa.git
   cd chat.bull.africa
   pnpm install

2. Configure Environment

   cp env.example .env
   # Edit .env with your API keys (Gemini recommended for free tier)

3. Switch AI Providers (Optional)

   • Follow Assistant-UI instructions
   • Supports: OpenAI, Anthropic, Azure, AWS, GCP, Groq, Fireworks, Cohere, Ollama, Chrome AI

4. Deploy to Cloudflare

   pnpm run deploy

That's it! Your AI chatbot is now live in 300+ locations worldwide.

pnpm run dev

pnpm run deploy

• Modify app/page.tsx for UI changes
• Update app/api/chat/route.ts for AI logic
• Customize themes in components/theme-provider.tsx

We welcome contributions! This project is built for the open-source community.

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit changes: git commit -m 'Add amazing feature'
4. Push to branch: git push origin feature/amazing-feature
5. 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: [email protected]
• 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.

1. Assistant-UI Documentation
2. Free LLM API Resources
3. Deep Thinking | Garry Kasparov | Talks at Google
4. Cloudflare Workers
5. Live Demo
6. My First AI Project
7. 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