3eb459a307d3075a19c738970d99530d4e8b9c3d
FishIQ
FishIQ is an intelligent fishing companion: trip planning, condition-aware recommendations, personal tackle, catch history, and the Professor Finn conversational guide.
First vertical slice
Lake Eufaula → largemouth bass → Saturday morning → conditions → recommended setup → ask Professor Finn.
Start locally
- Copy
.env.exampleto.env. - Run
docker compose up --build. - Open the web app at http://localhost:5173 and the API at http://localhost:8000/api/health/.
The initial API exposes health, water-body, species, trip, and recommendation endpoints. Seed data is created with:
docker compose exec api python manage.py seed_demo
See docs/ROADMAP.md for milestones and docs/ARCHITECTURE.md for boundaries.
Languages
Python
37%
CMake
24.6%
C++
15.4%
TypeScript
12.7%
HTML
4.3%
Other
6%