♻️ SymbioAI.Market

SymbioAI is an intelligent B2B marketplace and generative materials engine designed to power the circular economy. It connects industrial byproduct generators with manufacturers looking for secondary raw materials.

Using Groq LLaMA 3.3, SymbioAI automatically analyzes waste streams, calculates CO₂ avoidance, determines EPR compliance, and engineers direct circular reuse pathways—turning industrial waste into high-value secondary feedstock.

---

✨ Features

• 🧠 Generative Materials Engine: Automatically classifies waste streams (E-Waste, Plastics, Fly Ash, Metal Scrap, etc.) and provides real-time technical summaries for circular reprocessing.
• 🏭 Direct Procurement: B2B transaction system to submit offers for industrial byproduct volumes.
• 🧪 Automated Quality & Safety Protocols: AI-generated NFPA hazard levels, worker handling instructions, required PPE, and lab quality assays.
• 🌍 Environmental Metrics: Calculates displaced CO₂ extraction mitigation and verified Extended Producer Responsibility (EPR) credit units.
• 📍 Geospatial Node Mapping: Interactive facility mapping and logistics planning via Leaflet/WasteMap integrations.
• ⚡ Zero-Cost Benchmark Caching: In-memory caching for recurring benchmark materials to preserve API rate limits and deliver instant results.

---

🛠️ Tech Stack

Frontend:

• React 18 + Vite
• React Router DOM
• Lucide React (Icons)
• Custom CSS & Glassmorphism UI
• Firebase / Auth Context

Backend:

• Python 3.13+
• FastAPI & Uvicorn
• Groq Cloud API (llama-3.3-70b-versatile)
• Supabase (Database & Storage)
• Pydantic & Python-Dotenv

---

🚀 Quick Start (Local Development)

1. Clone the Repository

git clone https://github.com/SuDefRequests/symbioai.git
cd symbioai

---

2. Backend Setup (FastAPI)

Navigate to the backend directory, install dependencies, and set up your environment variables:

cd symbioai-backend
pip install -r requirements.txt

Create a .env file in the symbioai-backend directory:

GROQ_API_KEY=gsk_your_groq_api_key_here
GROQ_API_KEY_BACKUP=gsk_your_backup_groq_api_key_here
SUPABASE_URL=https://your-project-url.supabase.co
SUPABASE_KEY=your_supabase_service_role_or_anon_key
PORT=8000

Start the FastAPI server:

uvicorn main:app --reload --host 127.0.0.1 --port 8000

The backend will run at http://127.0.0.1:8000. Interactive API Swagger docs are available at http://127.0.0.1:8000/docs.

---

3. Frontend Setup (React / Vite)

Open a new terminal and navigate to the frontend directory:

cd symbioai-frontend/SymbioAI-frontend/symbioai-recykal-inspired
npm install
npm run dev

The frontend will run locally at http://localhost:5173.

---

🌐 Deployment

Deploying the Backend (Render)

1. Create a new Web Service on Render connected to SuDefRequests/symbioai.
2. Configure settings:
   • Root Directory:symbioai/symbioai-backend
   • Build Command:pip install -r requirements.txt
   • Start Command:uvicorn main:app --host 0.0.0.0 --port $PORT
3. Add your SUPABASE_URL, SUPABASE_KEY, and GROQ_API_KEY in the Environment settings.

Deploying the Frontend (Cloudflare Pages / Vercel)

1. Create a new project connected to SuDefRequests/symbioai.
2. Configure build settings:
   • Root Directory:symbioai/symbioai-frontend/SymbioAI-frontend/symbioai-recykal-inspired
   • Framework Preset:Vite
   • Build Command:npm run build
   • Output Directory:dist
3. Add VITE_API_URL pointing to your live Render backend URL in Environment Variables.

---

📁 Repository Structure

symbioai/
├── symbioai-frontend/
│ └── SymbioAI-frontend/
│ └── symbioai-recykal-inspired/
│ ├── public/
│ │ ├── _redirects # SPA fallback rules for Cloudflare Pages
│ │ └── images/ # Industrial stock photos & assets
│ ├── src/
│ │ ├── assets/ # Local images and icons
│ │ ├── components/ # Reusable UI components (WasteMap, Modals, Nav)
│ │ ├── context/ # AuthContext & state providers
│ │ ├── data/ # Listings, material photos mapping
│ │ ├── pages/ # Landing, Listings, ListingDetail, AccountPage, Dashboard
│ │ ├── styles/ # Modular CSS stylesheets
│ │ ├── utils/ # Socket & event bus utilities
│ │ └── App.jsx # Main application router
│ ├── package.json
│ └── vite.config.js
│
├── symbioai-backend/
│ ├── app/
│ │ ├── routers/ # FastAPI routes (listings, matches, profiles, upload)
│ │ ├── schemas/ # Pydantic data validation schemas
│ │ ├── services/ # Groq AI matching & classification engine
│ │ ├── config.py # App configuration & env loader
│ │ └── database.py # Supabase sync & persistence layer
│ ├── main.py # FastAPI ASGI application entrypoint
│ └── requirements.txt # Python production dependencies
│
├── .gitignore # Protected env secrets and build ignores
└── README.md

---

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.