README.md

metadata

title: Fyodor IDE
emoji: 💻
colorFrom: blue
colorTo: gray
sdk: gradio
sdk_version: 6.0.1
app_file: app.py
pinned: true
license: mit
short_description: A small demo of a future IDE named Fyodor-IDE
tags:
  - mcp-in-action-track-enterprise

🛡️ Fyodor IDE

Isolated AI Coding Environment for Secure Python Development

A secure, enterprise-grade AI coding assistant that executes code in ephemeral cloud sandboxes. Built with Gradio 6, MiniMax, and E2B for zero-trust code execution.

---

🚀 Features

1. Zero-Trust Security Architecture

• Sandboxed Execution: All Python code runs in E2B (Firecracker VMs), ensuring complete isolation from the host server
• No Internet Access: The agent is restricted to internal tools and libraries, preventing unauthorized data exfiltration
• Ephemeral Environments: Each execution starts fresh with no persistent state

2. "Mini IDE" Experience

• Dual-Column Layout: Chat interface on the left, live code editor on the right
• Live Edits: Modify AI-generated code directly in the browser and re-run it instantly
• Artifact Support: Renders matplotlib plots, pandas DataFrames, and images inline
• Syntax Highlighting: Full Python code highlighting for better readability

3. Enterprise Session Management

• Time-Boxed Sessions: Every session hard-resets after 15 minutes for security
• State Isolation: User states (history, code) are kept in memory and never written to disk
• No Persistent Storage: Ensures complete data privacy and compliance

4. Mobile Responsive

• Adaptive Layout: Full responsive CSS that stacks vertically on mobile devices
• Coding on the Go: Access your AI coding assistant from any device

---

☁️ Deployment on Hugging Face Spaces

Quick Start

1. Create a New Space

   • Go to Hugging Face Spaces
   • Click "Create new Space"
   • Select Gradio as the SDK
   • Choose a name for your Space (e.g., fyodor-ide)

2. Upload Files

   • Upload app.py and requirements.txt to your Space

3. Configure Secrets

   • Navigate to Settings → Variables and secrets
   • Add the following secrets:
     • MINIMAX_API_KEY: Your MiniMax API key (Get one here)
     • E2B_API_KEY: Your E2B API key (Get one here)
     • HF_TOKEN: (Optional) Your Hugging Face token if using HF inference models

4. Launch

   • Your Space will build and launch automatically
   • Access your IDE at https://huggingface.co/spaces/YOUR_USERNAME/fyodor-ide

Environment Variables

Variable	Required	Description
MINIMAX_API_KEY	✅ Yes	API key for MiniMax AI model
E2B_API_KEY	✅ Yes	API key for E2B sandbox execution
HF_TOKEN	⬜ Optional	Hugging Face token for additional models

---

🏗️ Architecture

┌─────────┐         ┌──────────────┐         ┌─────────────┐
│  User   │────────▶│  Fyodor IDE  │────────▶│  MiniMax-M2 │
│ Browser │         │  Gradio UI   │         │   AI Model  │
└─────────┘         └──────────────┘         └─────────────┘
                            │                        │
                            ▼                        ▼
                    ┌──────────────┐         ┌─────────────┐
                    │ Code Editor  │◀────────│Python Code  │
                    │   (Live)     │         │ Generation  │
                    └──────────────┘         └─────────────┘
                            │
                            ▼
                    ┌──────────────┐
                    │ E2B Sandbox  │
                    │ (Firecracker)│
                    └──────────────┘
                            │
                            ▼
                    ┌──────────────┐
                    │ Logs, Plots  │
                    │   & Output   │
                    └──────────────┘

---

📝 Usage Guide

Basic Workflow

1. Ask: Type a coding request like "Simulate a stock price random walk and plot it"
2. View: The AI generates Python code in the right-hand editor panel
3. Edit: Modify parameters or logic directly in the code editor
4. Run: Click ▶️ Run Modified Code to execute in the secure sandbox
5. Export: Click ⬇️ Export .py to download your code before the session expires

Example Prompts

• "Create a pandas DataFrame with sales data and plot a bar chart"
• "Generate 1000 random numbers and show a histogram"
• "Implement quicksort and visualize the sorting process"
• "Fetch iris dataset and train a simple classifier"

Session Management

• Session Duration: 15 minutes maximum
• Auto-Reset: Sessions automatically clear after timeout
• No Persistence: Export your work before leaving!

---

🛠️ Tech Stack

• Frontend: Gradio 6 (Python web framework)
• AI Model: MiniMax-M2 (code generation)
• Sandbox: E2B (Firecracker VM isolation)
• Language: Python 3.10+

---

🔒 Security Features

• ✅ Zero Network Access: Sandboxes cannot access the internet
• ✅ Process Isolation: Each execution runs in a separate VM
• ✅ Time-Limited Sessions: Automatic session expiration
• ✅ No Disk Persistence: All data stays in memory
• ✅ Input Sanitization: Code is validated before execution

---

📋 Requirements

gradio>=6.0.0
e2b-code-interpreter
openai  # or your preferred AI SDK
python-dotenv

---

🤝 Contributing

This project is designed for Hugging Face Spaces deployment. To suggest improvements:

1. Fork this Space
2. Make your changes
3. Submit a pull request or discussion thread

---

📄 License

MIT License - See LICENSE file for details

---

🆘 Support

• Issues: Open a discussion in your Hugging Face Space
• Documentation: E2B Docs | Gradio Docs
• Community: Hugging Face Discord

---

⚠️ Disclaimer

This tool executes arbitrary code in sandboxed environments. While E2B provides strong isolation, always review generated code before execution. Not recommended for production data processing without additional security review.

---

Built with ❤️ for secure AI-assisted development