Discover, chat, and find birds on campus with the power of AI and real-time data.
Titan Bird Trails is a next-generation, AI-powered web platform that transforms birdwatching at California State University, Fullerton. Experience campus nature like never before—guided by generative AI, real-time sightings, and smart recommendations.
- Campus Bird Finder: Instantly get AI-generated tips and live sighting data for any bird on campus. The system uses Google Gemini and the eBird API to tell you where and when your favorite bird was last seen, and how to spot it.
- Chat with a Bird: Have a real conversation with an AI that roleplays as your chosen bird, blending real facts and personality.
- AI Bird Poems: Generate creative, species-specific poems with a single click.
- Personalized Birding Tips: Receive actionable, AI-crafted advice for finding and appreciating birds in your local environment.
- Live Data Integration: All sightings are powered by the eBird API, ensuring up-to-date, location-specific results.
- AI-First Experience: Every interaction is powered by generative AI, making birding more interactive, educational, and fun.
- Real-Time Bird Finding: Combines AI with live campus data to help you find birds right now—not just in theory.
- Conversational Learning: Learn about birds by chatting with them, not just reading static info.
- Smart, Contextual Prompts: The platform uses retrieval-augmented generation (RAG-inspired) techniques, blending live data and curated knowledge for every AI response.
- React 18 + TypeScript: Modern, scalable frontend
- Vite: Lightning-fast development and builds
- Tailwind CSS + Shadcn/UI: Beautiful, responsive UI
- Google Gemini API: Generative AI for chat, tips, and poems
- eBird API: Real-time bird sighting data
- Secure Environment Variables: API keys never exposed
- Clone the repository
git clone https://github.com/MohitPatni0731/Birding-CSUF.git cd Birding-CSUF - Install dependencies
npm install
- Set up environment variables
VITE_GEMINI_API_KEY=your_gemini_api_key_here VITE_EBIRD_API_KEY=your_ebird_api_key_here
- Start the development server
npm run dev
- Anna's Hummingbird
- Red-shouldered Hawk
- American Crow
- Mourning Dove
- California Scrub-Jay
- California Towhee
- House Finch
- Lesser Goldfinch
- Black Phoebe
- Northern Mockingbird
- Wrentit
- Great Horned Owl
- Bushtit
- Song Sparrow
- European Starling
- American Coot
- Mallard
- Learn by Doing: AI chat and live data make birding hands-on and memorable.
- Campus Engagement: Connects students, faculty, and visitors with CSUF’s natural beauty.
- Science + Creativity: Blends ornithology, poetry, and technology for a unique learning experience.
We welcome contributions! Please open issues or pull requests for new features, bug fixes, or ideas.
MIT License. See LICENSE for details.
Made with ❤️ & 🐦 by students, for students • © 2025 California State University, Fullerton