OM. ← Back to projects

WEB • AI • AQUARISTICS

TankFlare

A website I designed and built that uses AI to answer the question every new fishkeeper gets wrong: will these fish, plants, and decorations actually live together?

YEAR2025 – 2026
TYPEWeb application
ROLEDesigner & developer
STATUSLive at tankflare.com
TankFlare freshwater aquarium planning interface
TankFlare helps aquarium hobbyists evaluate tank setups and make better stocking decisions.

OVERVIEW

The problem

Most aquarium mistakes are not made in the tank. They are made in the store aisle, minutes before checkout.

A beginner picks fish because they look good together, plants because they are green, and decor because it fits the theme. What they cannot see is that one fish needs soft acidic water while another needs hard alkaline water, that a plant needs more light than the tank will ever get, or that a beautiful piece of driftwood will slowly shift the pH in the wrong direction.

Compatibility information exists, but it is scattered across forums, care sheets, and contradictory blog posts. TankFlare pulls that reasoning into one place and applies it to the specific combination a person is actually considering.

HIGHLIGHTS

Key details

496Freshwater species profiles
45Compatibility signals evaluated
1,200+Monthly visitors

HOW IT WORKS

Three layers of compatibility

The user describes their tank: volume, water parameters, lighting, substrate, and current inhabitants, then adds what they are thinking of buying. TankFlare evaluates the combination on three fronts.

Fish ↔ Fish

Checks temperament, adult size, schooling needs, territory, swimming level, fin-nipping risk, and shared temperature, pH, and hardness ranges.

Fish ↔ Plants

Flags species that eat, uproot, or shred plants, then compares plant light and nutrient needs against the tank setup and suggests alternatives.

Fish ↔ Decor

Reviews substrate safety, sharp edges, driftwood and rock effects on water chemistry, and the cover needed for shy fish to feel secure.

Instead of returning a bare verdict, the AI explains why a pairing fails and what to change: a different species, a larger tank, or an adjustment to the setup.

AI MODEL

How TankFlare reaches a match

TankFlare uses an ensemble model to turn aquarium details into a clear compatibility recommendation.

More than 15,000 data points were collected and organized using personal freshwater-aquarium knowledge. Specialist XGBoost and LightGBM models evaluate signals from the tank setup, water parameters, bioload, and the fish-and-decor combination. Each model contributes an independent opinion; a logistic regression model then combines those predictions into the final match result.

Tank signals Tank conditions, water parameters, bioload, species, and decor details.
Model ensemble Multiple XGBoost and LightGBM models assess compatibility from different perspectives.
Final match A logistic regression model combines the ensemble's opinions into one recommendation.

ARCHITECTURE

How TankFlare works

A layered application architecture keeps the web experience, persistent aquarium data, and trained compatibility models clearly separated.

Presentation layer
Next.js · React · TypeScript

Responsive web interface, dashboards, stocking checker, species pages, logbook, and AI-assisted tools.

Application & API
REST / Server-side APIs

Handles application logic, validation, data access, authentication-related operations, and communication with hosted AI services.

Data layer
Firebase · Firestore

Stores aquarium data, user tank information, logs, species information, configuration, and application data.

AI / ML layer
Offline training → Hosted ML inference
Prepared dataHistorical compatibility records.
FeaturesEngineer tank and species signals.
TrainingTrain and evaluate models offline.
Saved modelExport the approved model.
Hosted APIReturn predictions and risk scores.

The model is not trained during normal website use. TankFlare sends compatibility features to a hosted inference API, which loads the pre-trained model and returns a prediction.

Infrastructure
Vercel

Hosts and deploys the Next.js application and server-side endpoints.

Analytics
Google Analytics

Tracks anonymized usage, page activity, and product engagement.

Next.js· React· TypeScript· Firebase· Firestore· Vercel· Google Analytics· Custom Machine Learning· REST APIs

EVIDENCE

Screenshots

REFLECTION

What I learned

TankFlare taught me that the interesting part of an AI product is rarely the model. It is deciding what the model is allowed to say, what data it must reason from, and how to present an answer that a beginner will actually trust and act on.

It brought together my interest in aquariums and software development to help fishkeepers make better-informed decisions for the health of their fish.