README.md

metadata

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.