Seebird AI — Your Personal Bird Identification Assistant 🌿

A functional, modern bird-identification chatbot built with HTML5, CSS3, and modern JavaScript.

🔗 GitHub Repository: https://github.com/yashbaghele-29/seebird-ai/tree/main

Features

  • 🦜 Intelligent Chatbot Interface: Ask any question about bird species, plumage patterns, feeding habits, migration, and conservation.
  • 📸 Photo Identification: Upload or drag-and-drop any bird photo (or paste from clipboard). Seebird extracts visual color palettes and provides high-confidence species matches.
  • 🔍 Identify by Traits Wizard: Interactive multi-select helper to identify unknown birds by Color, Size, and Habitat.
  • 🔊 Procedural Birdsong Synthesizer: Uses native Web Audio API oscillators to play realistic chirps, trills, whistles, and hoots with zero external audio dependencies.
  • 📖 Interactive Field Guide: Searchable species directory with scientific names, IUCN conservation status badges, and diet specs.
  • 📝 Birding Life List (Sightings Logger): Record bird sightings with date, location, and field notes; stored locally and exportable to JSON.
  • ⚙️ Dual AI Engine Modes:
    1. Built-in Naturalist AI: Runs 100% offline and locally in the browser with no API key or installation needed.
    2. Custom / Eachlabs AI Mode: Supports connecting kling/kling-element, Eachlabs, or any OpenAI-compatible API endpoint with your own API key.
  • 🌓 Dark & Light Mode: Accessible nature-inspired aesthetic.

File Structure 

seebird-ai/ ├── index.html # Main application layout and modal interfaces ├── styles.css # Responsive styling and themes (Light & Dark) ├── birds-db.js # Curated species database with acoustic & physical profiles ├── audio-synth.js # Web Audio API bird song procedural synthesizer ├── app.js # Chat controller, vision color analyzer, and life list manager └── README.md # Documentation

How to Run

  1. Open index.html directly in any modern web browser (Chrome, Edge, Firefox, Safari).
  2. Alternatively, serve with a lightweight local web server: 
 npx serve . # or python -m http.server 8000