News Intelligence

Lightweight full-stack app for weekly Technology news intelligence from Vietnamese sources (VnExpress, Thanh Nien, Tuoi Tre).

UI Preview

Stack

• Backend: FastAPI (/backend)
• Frontend: React + Vite (/frontend)

Prerequisites

• Python 3.11+
• Node.js 18+
• uv (recommended for backend)

1) Backend Setup & Run

cd backend
cp .env.example .env

Set your key in .env:

GEMINI_API_KEY=your_api_key_here

Install + run:

uv sync
uv run uvicorn main:app --reload --host 127.0.0.1 --port 8000

Backend URLs:

• API docs: http://127.0.0.1:8000/docs
• Health: http://127.0.0.1:8000/api/health

2) Frontend Setup & Run

cd frontend
npm install
npm run dev

Frontend URL:

• http://localhost:5173

3) Run the Pipeline

From backend docs (/docs) or cURL:

curl -X POST "http://127.0.0.1:8000/api/pipeline/run" \
  -H "Content-Type: application/json" \
  -d '{"topic":"technology","days":7,"prompt_version":"analyst_v2"}'

Check status:

curl "http://127.0.0.1:8000/api/pipeline/status"

Prompt Versions

Use prompt_version when running the pipeline:

• structured_v1: strict structured output
• analyst_v2: richer analyst-style writing
• zero_shot: simple baseline

Where to mention prompt choice:

• In this README: list available options (this section).
• In each report: store which prompt was used for reproducibility.

Current behavior:

• prompt_version is returned by /api/pipeline/run.
• report filename already includes it, e.g. weekly_report_technology_analyst_v2.json.

Recommended report metadata block (optional):

{
  "metadata": {
    "prompt_version": "analyst_v2",
    "generated_at": "2026-04-23T10:30:00+07:00",
    "model": "gemini-2.5-flash-preview-04-17"
  }
}

Output Files

• Processed data: backend/data/processed/
• Reports: backend/data/reports/

Important Note

Current frontend is in demo mode (loads local JSON in frontend/public/demo) and does not call backend APIs yet.

Future Contributions

Contributions are welcome. To keep changes aligned:

1. Open an issue first and describe the problem/idea.
2. Wait for maintainer feedback on scope.
3. Submit a focused pull request linked to that issue.

Quick start:

• Create issue: Issues tab -> New issue
• Suggested labels: bug, enhancement, documentation
• Keep PRs small and include clear reproduction/validation steps

License

This project is licensed under the MIT License. See LICENSE.