EcoMate is a comprehensive platform for environmental technology management, combining intelligent automation with comprehensive documentation. This repository contains both the documentation site and AI-powered services for research, supplier management, and compliance monitoring.
Comprehensive product, operations, and go-to-market documentation built with MkDocs Material and published to GitHub Pages. Includes automated PDF/Word exports for client deliverables.
Intelligent automation services for environmental technology research, supplier synchronization, price monitoring, specification drafting, and compliance checks. Built with FastAPI, Temporal workflows, and advanced AI models.
# Set up documentation environment
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
# Serve documentation locally
mkdocs serve # Access at http://127.0.0.1:8000
# Navigate to AI services directory
cd ecomate-ai
# Set up environment
cp .env.example .env
# Edit .env with your configuration
# Start infrastructure services
docker compose up -d postgres minio temporal nats
# Install Python dependencies
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
# Start services
python services/orchestrator/worker.py # Terminal 1
uvicorn services.api.main:app --reload --port 8080 # Terminal 2
EcoMate/
├── docs/ # Documentation content (Markdown)
│ ├── products/ # Product specifications and guides
│ ├── operations/ # Standard operating procedures
│ ├── suppliers/ # Supplier database and RFQ templates
│ └── marketing/ # Go-to-market materials
├── ecomate-ai/ # AI Services Platform
│ ├── services/ # Microservices (API, parsers, orchestrator)
│ ├── tests/ # Comprehensive test suite
│ ├── storage/ # Database initialization
│ └── docker-compose.yml # Infrastructure services
├── data/ # CSV data files for documentation
├── scripts/ # Automation and export scripts
├── overrides/ # MkDocs theme customizations
└── .github/workflows/ # CI/CD automation
Our development is guided by a dynamic, unified set of artifacts:
| Document | Description |
|---|---|
| Master Index & Roadmap Overview | Top-level entry point with links and summaries of all roadmap documents |
| Future Roadmap (Living Document) | Phased development plan from foundation to autonomous ecosystem |
| Production Implementation Plan | Immediate codebase-ready drop-ins and steps for Phase 1 |
| Market & Supply Chain Data Integration | Vendor APIs, competitor monitoring, and alternative sourcing |
| Regulatory & Compliance Data Integration | Standards APIs, legal feeds, and public record checks |
| Environmental & Geographic Data Integration | Geospatial, climate, and permit-awareness enhancements |
| Operational & Predictive Data Integration | IoT ingestion, predictive maintenance, and digital twin modeling |
Start with the Master Index to navigate quickly to the relevant blueprint.
main triggers GitHub Actions deploymentmain branch triggers GitHub Actions deploymentmkdocs gh-deploy for immediate deploymentmkdocs serve for developmentdata/*.csv filesscripts/google_sheets_sync_example.gsmake pdf - Creates client-ready PDF documentationmake docx - Word format for collaborative editingWe welcome contributions to both the documentation and AI services platforms!
docs/ directorymkdocs serveThis project is licensed under the MIT License - see the LICENSE file for details.
docs labelai-services labelEcoMate - Intelligent Environmental Technology Management