{"id":48216381,"url":"https://github.com/vitalcheffe/flow","last_synced_at":"2026-04-04T19:00:27.620Z","repository":{"id":348581721,"uuid":"1198792244","full_name":"Vitalcheffe/flow","owner":"Vitalcheffe","description":"Open-source engineering simulation with AI. In your browser.","archived":false,"fork":false,"pushed_at":"2026-04-02T00:28:59.000Z","size":104,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-02T06:42:12.945Z","etag":null,"topics":["cfd","engineering","fea","finite-element","open-source","physics","python","react","simulation","typescript"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Vitalcheffe.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-01T19:04:44.000Z","updated_at":"2026-04-01T21:49:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Vitalcheffe/flow","commit_stats":null,"previous_names":["vitalcheffe/flow"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Vitalcheffe/flow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vitalcheffe%2Fflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vitalcheffe%2Fflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vitalcheffe%2Fflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vitalcheffe%2Fflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vitalcheffe","download_url":"https://codeload.github.com/Vitalcheffe/flow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vitalcheffe%2Fflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31409471,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cfd","engineering","fea","finite-element","open-source","physics","python","react","simulation","typescript"],"created_at":"2026-04-04T19:00:16.253Z","updated_at":"2026-04-04T19:00:27.601Z","avatar_url":"https://github.com/Vitalcheffe.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FLOW\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eOpen-source engineering simulation with AI. In your browser.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/Vitalcheffe/flow/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/Vitalcheffe/flow/ci.yml?branch=main\u0026style=for-the-badge\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge\" alt=\"MIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/Vitalcheffe/flow\"\u003e\u003cimg src=\"https://img.shields.io/badge/Python-3.11+-blue?style=for-the-badge\u0026logo=python\" alt=\"Python\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/Vitalcheffe/flow\"\u003e\u003cimg src=\"https://img.shields.io/badge/React-18-61DAFB?style=for-the-badge\u0026logo=react\" alt=\"React\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nFLOW lets engineers run structural, thermal, and fluid simulations in the browser. No $50K license. No 6-month training. Open the browser, import your geometry, simulate.\n\nAI-powered solvers (Neural Operators) make simulations 100x faster than traditional FEA. What takes ANSYS 4 hours, FLOW does in 2 seconds.\n\n## Why\n\n- ANSYS costs $50K+/year. COMSOL costs $10K+. ABAQUS costs $30K+.\n- Free tools (FreeCAD, CalculiX) are clunky, desktop-only, slow.\n- Engineers in Africa, Asia, South America have zero access to simulation.\n- AI (Neural Operators) can accelerate physics simulation by 100-1000x. This is active research (ICLR 2025, 2026) but nobody has made it a product.\n\nFLOW is that product.\n\n## Features\n\n- **Structural Analysis** — stress, strain, deformation under load\n- **Thermal Analysis** — heat transfer, steady-state and transient\n- **Fluid Dynamics** — laminar flow, basic CFD\n- **AI Solver** — Fourier Neural Operator for real-time results\n- **3D Viewer** — Three.js-based, interactive, works in browser\n- **Import** — STEP, IGES, STL, OBJ geometry files\n- **Export** — CSV, JSON, VTK result formats\n- **API** — REST API for automation and CI/CD integration\n- **Self-host** — Docker one-liner, runs anywhere\n\n## Quick Start\n\n```bash\n# Backend\ncd backend\npip install -r requirements.txt\npython -m app.main\n\n# Frontend (separate terminal)\ncd frontend\nnpm install\nnpm run dev\n```\n\nOr with Docker:\n\n```bash\ndocker compose up\n```\n\nVisit http://localhost:5173\n\n## Architecture\n\n```\nflow/\n├── backend/           # Python FastAPI server\n│   ├── app/\n│   │   ├── api/       # REST endpoints\n│   │   ├── core/      # Config, logging, middleware\n│   │   ├── solvers/   # FEA, thermal, fluid solvers\n│   │   ├── neural/    # Neural Operator models\n│   │   ├── models/    # Database models (SQLAlchemy)\n│   │   └── schemas/   # Pydantic request/response schemas\n│   └── tests/\n├── frontend/          # React + TypeScript + Vite\n│   └── src/\n│       ├── components/\n│       │   ├── viewer/      # 3D geometry viewer\n│       │   ├── simulation/  # Simulation controls\n│       │   └── ui/          # Shared UI components\n│       ├── pages/\n│       ├── hooks/\n│       └── lib/\n├── docker/            # Dockerfiles\n├── docs/              # Documentation\n├── examples/          # Example simulations\n└── scripts/           # Build and deploy scripts\n```\n\n## Solvers\n\n| Solver | Type | Speed | Use Case |\n|--------|------|-------|----------|\n| `fea_classic` | FEM | Baseline | Structural analysis, validation |\n| `fea_neural` | Neural Operator | 100x | Real-time structural |\n| `thermal_classic` | FEM | Baseline | Heat transfer |\n| `thermal_neural` | Neural Operator | 200x | Real-time thermal |\n| `fluid_classic` | FVM | Baseline | Laminar CFD |\n| `fluid_neural` | Neural Operator | 500x | Real-time fluid |\n\n## Comparison\n\n| Feature | ANSYS | COMSOL | FreeCAD | **FLOW** |\n|---------|-------|--------|---------|----------|\n| Price | $50K+ | $10K+ | Free | **Free** |\n| Web-based | No | No | No | **Yes** |\n| AI solver | No | No | No | **Yes** |\n| Mobile | No | No | No | **Yes** |\n| Open source | No | No | Yes | **Yes** |\n| Self-host | No | No | N/A | **Yes** |\n| API | No | Limited | No | **Yes** |\n| Learning curve | 6 months | 3 months | 2 months | **10 minutes** |\n\n## API\n\n```bash\n# Create simulation\ncurl -X POST http://localhost:8000/api/v1/simulations \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"bridge-beam\", \"solver\": \"fea_neural\", \"geometry\": \"beam.step\"}'\n\n# Run simulation\ncurl -X POST http://localhost:8000/api/v1/simulations/1/run\n\n# Get results\ncurl http://localhost:8000/api/v1/simulations/1/results\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvitalcheffe%2Fflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvitalcheffe%2Fflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvitalcheffe%2Fflow/lists"}