尚未检测到更新。GitHub 发布版本后会显示在这里。
个人 GitHub 账号下公开仓库的所有者可以登录并验证所有权,自行管理介绍,无需管理员批准。
登录并生成验证文件,在 30 分钟内将其提交到此仓库的默认分支。其他分支或分叉仓库中的文件无效。然后在下方检查文件,即可无需管理员批准直接管理项目。请保留文件以维持管理权限。
如需登录,将前往登录页面。登录后请回到此处,再次点击所选的验证按钮。
在项目文件夹中运行 /nomorevibe verify,即可验证所有权并自行管理介绍。
一分钟完成验证制作者的介绍仅有上面的一句话。 更多详情请阅读仓库 README。 仓库 README ↗
正在加载完整 README。
查看完整 README ↗Public-sector data analytics engine — from messy public files to decisions you can defend. Web app + public REST API that runs the full analytics lifecycle on government data: ingest → profile → guided cleaning → SQL modeling → machine learning → executive dashboard and report. UI in English and Spanish; input data in English, French or Spanish.
🚧 Status: Phase 0 — scaffold. See
docs/ROADMAP.mdfor the 25-day plan.
Public data arrives fragmented, multilingual and dirty, and executive reporting is often manual. CivicLens shows — step by step — how to turn it into reliable KPIs and decision support, and lets agencies repeat the same pipeline every month through an API.
| Layer | Choice |
|---|---|
| Web | Next.js 14 · TypeScript · Tailwind · next-intl (EN/ES) · Vercel |
| API | FastAPI · Python 3.11 · Docker · Render |
| Analytics | DuckDB + Parquet · pandas |
| App data | PostgreSQL (Neon) |
| ML | scikit-learn · statsmodels · SHAP |
| CI/CD | GitHub Actions |
cp .env.example .env
docker compose up --build
# web → http://localhost:3000 (redirects to /en or /es)
# api → http://localhost:8000/health docs → http://localhost:8000/docs
Without Docker:
# API
cd apps/api && python -m venv .venv && . .venv/bin/activate && pip install -e ".[dev]"
uvicorn app.main:app --reload
# Web
cd apps/web && npm install && npm run dev
apps/web Next.js app (UI, i18n catalogs in messages/en.json and messages/es.json)
apps/api FastAPI service (analytics engine + public API)
data/seed Frozen public datasets + dataset cards
docs/ Spec, roadmap, ADRs, glossary
scripts/ Tooling (i18n catalog check, seed loading)
Ruff + pytest with coverage (API) · ESLint + typecheck + build (web) · EN/ES catalog parity · gitleaks secret scan · Docker build.
CivicLens es un motor de analítica para datos públicos: carga archivos en inglés, francés o español, enseña a limpiarlos, los modela en SQL, aplica modelos de machine learning explicables y genera el reporte ejecutivo. La interfaz está disponible en inglés y español, y todo el proceso se puede automatizar mediante una API para entidades públicas.
María Alejandra Boada Rodríguez — Data Analyst · Software Engineer
MIT. Dataset licenses and attribution are listed in data/seed/README.md.