---
title: MindsEye Sandbox FlowStudio
emoji: 🧠
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.0.0
app_file: app.py
pinned: true
thumbnail: assets_07/thumbnail.png
short_description: MindsEye flow & chat sandbox (no APIs).
license: mit
---

# MindsEye Sandbox FlowStudio

This repository powers a Hugging Face Space that combines:

1. **MindsEye Chat** — a local-only chatbot with a small MindsEye knowledge base.  
2. **MindsEye Flow Studio** — a text-based flowchart builder where you define nodes and edges, render a Mermaid diagram, and simulate execution.

No external APIs.  
No Google / Gemini / OpenAI.  
Just pure Python + Gradio + in-repo knowledge and flow logic.

## Structure

- `01_docs/` — architecture and flow studio specs  
- `app_02/` — Gradio UI (Chat tab + Flow Studio tab)  
- `engine_03/` — knowledge engine + flow graph engine  
- `flows_04/` — sample flows in JSON (can be loaded later)  
- `config_05/` — configuration and Space-related settings  
- `tests_06/` — basic tests for flow engine and knowledge  
- `assets_07/` — thumbnail and logos for the Space  
- `app.py` — Hugging Face entrypoint  
- `requirements.txt` — dependencies (Gradio only)

## Running locally

```bash
pip install -r requirements.txt
python app.py