Replication Guide¶
Deploy your own AirChain instance for other cities/countries.
Architecture¶
- Backend: FastAPI + PostgreSQL + MQTT
- Blockchain: Cardano node + PyCardano
- Sensors: Raspberry Pi Pico + PMS5003 + A7670SA
- Frontend: React + Mapbox
Prerequisites¶
- Ubuntu 22.04 server (4GB+ RAM)
- Cardano node (or use Blockfrost API)
- MQTT broker (Mosquitto)
- Domain name
Step 1: Deploy Backend¶
git clone https://github.com/airchain-ng/backend.git
cd backend
pip install -r requirements.txt
# Configure environment
cp .env.example .env
# Edit .env with your settings
# Run migrations
alembic upgrade head
# Start server
uvicorn main:app --host 0.0.0.0 --port 8000
Step 2: Build Sensors¶
See Operator Installation Guide
Step 3: Deploy Frontend¶
git clone https://github.com/airchain-ng/dashboard.git
cd dashboard
npm install
npm run build
Customization¶
- Update location coordinates
- Configure AQI thresholds
- Customize branding
- Modify token economics
Support¶
For replication support: devs@airchain.ng