---
title: Ethrix-Forge
emoji: 🛠️
colorFrom: blue
colorTo: indigo
sdk: docker
app_file: app.py
pinned: false
---
# 🛠️ Ethrix-Forge : AI Auto-Coding Agent

Welcome to the official cloud workspace of **Ethrix-Forge**, a next-generation AI-powered Code Editor and autonomous development environment. 

## 🚀 The Vision
Ethrix-Forge is not just another IDE; it is your AI co-founder. Designed to generate, execute, and sync code autonomously, it empowers developers to build and scale projects at lightning speed—perfect for high-stakes hackathons and fast-paced tech startups.

## ✨ Key Features
* **🧠 Multi-API AI Engine**: Seamlessly switch between Google Gemini (2.0 Flash), Groq, and OpenRouter for uninterrupted auto-coding.
* **💻 VS Code Experience**: Deep integration with Monaco Editor for professional syntax highlighting and file management.
* **⚡ Live Preview**: Instantly render and test HTML/CSS/JS combinations with a single click.
* **☁️ Auto-Save & Cloud Sync**: Powered by MongoDB to ensure zero data loss, automatically saving files and chat history every few seconds.
* **🛠️ Hackathon Ready**: Built-in 1-click GitHub repo cloning/pushing and Google Drive ZIP exports to beat strict deadlines.

## 🧰 Tech Stack
* **Frontend**: React (Vite) + Monaco Editor
* **Backend**: Python (FastAPI) + Uvicorn
* **Database**: MongoDB (Async Motor)
* **Cloud Platform**: Hugging Face Spaces (Docker) + GitHub

## 🔐 Environment Variables (Hugging Face Secrets)
To securely run this space without exposing credentials, the following variables must be set in the Space Settings:
* `GEMINI_API_KEY`: Google Gemini API Key
* `GROQ_API_KEY`: Groq API Key
* `MONGO_URI`: MongoDB Connection String
* `GITHUB_TOKEN`: Personal Access Token for Repo operations

---
*Built with ❤️ by Shantanu | Scaling towards the future of AI Engineering.*