Daniel-Ramos-Dev/ecolytix
Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Repository files navigation
🌍 Ecolytix Decentralized environmental monitoring infrastructure powered by real-world IoT sensors and verified on Solana blockchain.     Overview Ecolytix is a real-time environmental monitoring platform that combines IoT hardware, artificial intelligence, blockchain verification, and real-time dashboards. The platform captures environmental telemetry using physical air-quality sensors connected to an Arduino-based edge node. Sensor readings are processed through a FastAPI backend, analyzed by an AI engine, and permanently verified on Solana Devnet. The objective of Ecolytix is to create transparent and tamper-proof environmental monitoring infrastructure for smart cities, industrial environments, and public health systems. Key Features - Real-time environmental monitoring - Physical IoT hardware integration - AI-powered telemetry analysis - Solana blockchain verification - Immutable environmental records - Real-time dashboard visualization - Modular and scalable architecture 🏗️ Architecture MQ135 Sensor ↓ Arduino Uno ↓ USB Serial Python Serial Bridge ↓ FastAPI Backend ↓ AI Analysis Engine ↓ Solana Devnet Memo Program ↓ SQLite Database ↓ Web Dashboard Hardware Components | Component | Purpose | | -------------- | --------------------------- | | Arduino Uno | Sensor controller | | MQ135 | Air quality sensor | | LEDs | Visual pollution indicators | | USB Serial | Data transmission | | Linux Computer | Edge processing | ⚙️ Software Stack Backend Python FastAPI SQLite Solana SDK PySerial Frontend HTML CSS JavaScript Blockchain Solana Devnet Memo Program 🧬 AI Engine The AI module analyzes historical environmental telemetry in real time to identify: Pollution spikes Environmental stability Air quality improvement trends The analysis engine compares recent sensor readings against historical averages to generate contextual environmental insights. ⛓️ Blockchain Verification Every environmental reading generated by the physical hardware is written to Solana Devnet using the Memo Program. This creates: Verifiable telemetry Immutable environmental records Transparent monitoring history Users can inspect transaction hashes directly through Solana Explorer. Project Structure ecolytix/ │ ├── arduino/ │ └── sensor_node.ino │ ├── backend/ │ ├── main.py │ ├── database.py │ ├── ai_engine.py │ ├── blockchain.py │ ├── serial_bridge.py │ └── requirements.txt │ ├── frontend/ │ ├── index.html │ ├── css/ │ │ └── style.css │ │ │ └── js/ │ ├── app.js │ ├── api.js │ └── charts.js │ └── README.md Setup 1. Clone Repository git clone https://github.com/YOUR_USERNAME/ecolytix.gitcd ecolytix 2. Create Virtual Environment python3 -m venv venv 3. Activate Virtual Environment source venv/bin/activate 4. Install Dependencies cd backendpip install -r requirements.txt 🔑 Solana Setup Install Solana CLI https://solana.com/docs/intro/installation Create Wallet solana-keygen new Configure Devnet solana config set --url devnet Request Devnet SOL solana airdrop 1 Hardware Wiring MQ135 → Arduino | MQ135 | Arduino | | ----- | ------- | | VCC | 5V | | GND | GND | | A0 | A0 | LEDs | LED | Pin | | ------ | --- | | Green | 2 | | Yellow | 3 | | Red | 4 | Terminal 1 cd backend uvicorn main:app --reload Terminal 2 cd backend python3 serial_bridge.py Frontend Open: frontend/index.html Example API Response { "air_quality": 121, "status": "GOOD", "insight": "Environmental conditions stable.", "tx_hash": "66WArmPByfUS..." } Solana Verification Transactions can be verified on: https://explorer.solana.com/?cluster=devnet Use Cases Smart cities Industrial pollution monitoring Environmental transparency Public health infrastructure Decentralized environmental telemetry Real-time monitoring networks Future Improvements Multi-node sensor networks GPS geolocation Predictive machine learning models Mobile application NFT environmental certifications DAO-based environmental governance Real-time public alert systems 👨💻 Team Daniel Lima Ramos Software Engineering • Backend • IoT • Blockchain • Presentation Arthur Felipe Lima Bomfim Frontend Engineering • UI Development • Research Helen Costa Fernandez Ventura UI/UX Design • Product Design Hackathon Built for the Solana Global Hackathon. License MIT License