AnimaGo gamifies wildlife conservation by harnessing the power of videogame addicts to promote wildlife fundraisers, increase outdoor activity, and popularize citizen science.

• Python 3.11
• uv 0.27.0
• Flet
• Firebase
• FastAPI

• Moondream
• OpenCV
• PyTorch
• YOLOv8
• Segment Anything Model 2

• GeoPy
• Leaflet (via WebView)

• Real-time animal recognition
• AR overlay
• Pokedex (biodex? idk)
• Gamified capture system (image clearness, resolution, etc)
• Live tracking map
• Daily/weekly animal challenges to encourage tracking of certain species
• XP/leveling system
• Leaderboard (animals found, accuracy, streaks)
• Weather & time integration
• Global heatmap of sightings + comments on each sighting
• Guilds (turn-based battler with animals you've found)
• Animal leveling based on number found
• Achievements & badges
• Sound recognition
• ML-based image enhancement
• Behavior recognition
• Auto-generate stickers
• Wildlife conservation donations + time-limited/sponsored events
• "Triple Kill" (multiple in one image; maybe call it multi-capture bonus)
• Thermal camera mode for nocturnal animals
• Animal migration events (birds, sea turtles, wildebeests)
• Nature preservation quests (clean up trash, plant trees, report illegal poaching)
• Biome mastery (80% documentation of a certain biome)
• PvP mode (biome mastery battles between guilds where you try and fill a biodiversity bar before the other guild; like clan wars)
• Livestreaming with chats + donations
• SPECIES DISCOVERY: visually distinct species which haven't been named get bonuses
• Virtual museum of rare species
• "Education Edition"
• Colorblind mode

• Python 3.11 or higher
• uv package manager

1. Install uv globally:

python -m pip install uv

2. Clone the repository:

git clone https://github.com/Tetraslam/AnimaGo.git
cd AnimaGo

3. Create and activate a virtual environment with uv:

uv venv
# On Windows
.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate

4. Install dependencies:

uv pip compile pyproject.toml -o requirements.lock
uv pip sync requirements.lock

git pull
uv pip sync requirements.lock

1. Install Python dependencies:

pip install -r requirements.lock

1. Download the Segment Anything Model (SAM) weights:

curl -L https://dl.fbaipublicfiles.com/segment_anything/sam_vit_h_4b8939.pth -o sam_vit_h_4b8939.pth

This file is required for the sticker creation feature which uses SAM to extract animals from images.

To run the app on your mobile device:

# For Android
flet run src/main.py --android

# For iOS
flet run src/main.py --ios

Scan the QR code that appears with your device's camera app.