HereWeGo!PT - Your personal scout for transfer news

HereWeGo!PT is a web app that helps you stay organized and up to date with the chaotic world of football transfers. Just search for a player, manager, or club, and instantly get a concise and accurate summary of the latest tweets from trusted sources — no endless scrolling required.

🔎 Search by name
🧠 Summarized using LLMs
⚡️ Powered by FAISS for fast similarity search
📊 Backed by a structured SQLite + vector store pipeline

Whether you're tracking your favorite club or scouting potential signings, HereWeGo!PT gives you the inside scoop — fast, simple, and organized.

Local development

Use Node 22 (the repository includes an .nvmrc) and Python 3.11+.

cd frontend
npm install
npm run dev

Create and activate the Python environment once:

python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install -r backend/requirements.txt

Then run the Flask API in a second terminal:

source .venv/bin/activate
cd backend
flask --app backend run --debug

The Next.js server uses BACKEND_URL for the Flask origin and defaults to http://127.0.0.1:5000. Set BACKEND_URL in frontend/.env.local when using a deployed API. Locally, Flask reads data/tweets.db and data/faiss_index; TWEETS_DB_PATH and FAISS_INDEX_PATH can override those locations.

Checks

.venv/bin/python -m unittest discover -s backend/tests -v
cd frontend && npm run typecheck && npm run lint && npm run build