Repository files navigation

BentoPi is a multi-purpose, self-hosted dashboard designed for Raspberry Pi. It provides real-time information such as weather, news, and transport disruptions, making it ideal for home automation, information kiosks, or personal dashboards.

• Self-hosted: All data is processed and displayed locally on your Raspberry Pi.
• Dashboard: Aggregates weather, news, and transport information in a single interface.
• Extensible: Easily add new data sources or dashboard widgets.
• Modern UI: Built with React and Ant Design for a responsive, user-friendly experience.
• API Backend: FastAPI-based backend for data aggregation and sensor integration.

• frontend/: React + TypeScript dashboard UI.
• backend/: FastAPI Python backend serving APIs and static files.

• Node.js >= 22 and pnpm >= 10 for frontend.
• Python >= 3.10 for backend.

cd frontendpnpm ipnpm start

• Access the dashboard athttp://localhost:5173 (default Vite port).

cd backendmake venvsource venv/bin/activatemake upgrademake

• Backend API runs athttp://localhost:8000.

cd frontendpnpm build

• The build output will be placed infrontend/dist/.

1. Build the frontend as above.
2. The build output will be automatically copied to the backend's web directory (automated in Docker build).
3. Start the backend:

cd backendmake venvsource venv/bin/activatemake upgrademake prod

• Access the dashboard athttp://localhost:8000/web.

Build and run the complete system using Docker:

cd backenddocker build -t bentopi.docker run -p 8000:8000 bentopi

• Frontend: Hot-reloading, TypeScript, React 19, Ant Design 5.
• Backend: FastAPI, CORS enabled, sensor integration via SMBus.
• Testing: Runpnpm test in frontend,make test in backend.

MIT