@@ -0,0 +1,77 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      publish_to:
+        description: 'Publish target'
+        required: true
+        default: 'testpypi'
+        type: choice
+        options:
+          - testpypi
+          - pypi
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install Python build tools
+        run: pip install build twine
+
+      - name: Install Python dependencies
+        run: |
+          pip install -r scripts/config/requirements-pyodide.txt
+          pip install -r scripts/config/requirements-build.txt
+
+      - name: Install Node dependencies
+        run: npm ci
+
+      - name: Extract blocks from PathSim
+        run: npm run extract
+
+      - name: Build package (frontend + wheel)
+        run: python scripts/build_package.py
+
+      - name: Check distribution
+        run: twine check dist/*
+
+      - name: Publish to Test PyPI
+        if: github.event_name == 'workflow_dispatch' && inputs.publish_to == 'testpypi'
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.TEST_PYPI_TOKEN }}
+        run: twine upload --repository testpypi dist/*
+
+      - name: Publish to PyPI
+        if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && inputs.publish_to == 'pypi')
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
+        run: twine upload dist/*
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
@@ -38,6 +38,9 @@ tmpclaude-*
 
 
 __pycache__/
+*.egg-info/
+dist/
+pathview_server/static/
 
 # Generated screenshots
 static/examples/screenshots/
@@ -17,29 +17,39 @@ A web-based visual node editor for building and simulating dynamic systems with
 - [Plotly.js](https://plotly.com/javascript/) for interactive plots
 - [CodeMirror 6](https://codemirror.net/) for code editing
 
-## Getting Started
+## Installation
+
+### pip install (recommended for users)
+
+```bash
+pip install pathview
+pathview serve
+```
+
+This starts the PathView server with a local Python backend and opens your browser. No Node.js required.
+
+**Options:**
+- `--port PORT` — server port (default: 5000)
+- `--host HOST` — bind address (default: 127.0.0.1)
+- `--no-browser` — don't auto-open the browser
+- `--debug` — debug mode with auto-reload
+
+### Development setup
 
 ```bash
 npm install
 npm run dev
 ```
 
-To use the Flask backend (server-side Python):
+To use the Flask backend during development:
 
 ```bash
-pip install -r server/requirements.txt
+pip install flask flask-cors
 npm run server   # Start Flask backend on port 5000
 npm run dev      # Start Vite dev server (separate terminal)
 # Open http://localhost:5173/?backend=flask
 ```
 
-For production:
-
-```bash
-npm run build
-npm run preview
-```
-
 ## Project Structure
 
 ```
@@ -82,10 +92,11 @@ src/
 ├── routes/                # SvelteKit pages
 └── app.css                # Global styles with CSS variables
 
-server/
+pathview_server/           # Python package (pip install pathview)
 ├── app.py                 # Flask server (subprocess management, HTTP routes)
 ├── worker.py              # REPL worker subprocess (Python execution)
-└── requirements.txt       # Server Python dependencies
+├── cli.py                 # CLI entry point (pathview serve)
+└── static/                # Bundled frontend (generated at build time)
 
 scripts/
 ├── config/                # Configuration files for extraction
@@ -467,15 +478,21 @@ Browser Tab                     Flask Server                  Worker Subprocess
 └──────────────┘               └──────────────────┘          └──────────────────┘
 ```
 
-**Setup:**
+**Standalone (pip package):**
 
 ```bash
-pip install -r server/requirements.txt
-npm run server   # Starts Flask on port 5000
-npm run dev      # Starts Vite dev server (separate terminal)
+pip install pathview
+pathview serve
 ```
 
-Then open `http://localhost:5173/?backend=flask`.
+**Development (separate servers):**
+
+```bash
+pip install flask flask-cors
+npm run server   # Starts Flask API on port 5000
+npm run dev      # Starts Vite dev server (separate terminal)
+# Open http://localhost:5173/?backend=flask
+```
 
 **Key properties:**
 - **Process isolation** — each session gets its own Python subprocess
@@ -666,7 +683,8 @@ https://view.pathsim.org/?modelgh=pathsim/pathview/static/examples/feedback-syst
 |--------|---------|
 | `npm run dev` | Start Vite development server |
 | `npm run server` | Start Flask backend server (port 5000) |
-| `npm run build` | Production build |
+| `npm run build` | Production build (GitHub Pages) |
+| `npm run build:package` | Build pip package (frontend + wheel) |
 | `npm run preview` | Preview production build |
 | `npm run check` | TypeScript/Svelte type checking |
 | `npm run lint` | Run ESLint |
@@ -783,14 +801,23 @@ Port labels show the name of each input/output port alongside the node. Toggle g
 
 ## Deployment
 
-PathView uses a dual deployment strategy with automatic versioning:
+PathView has two deployment targets:
+
+### GitHub Pages (web)
 
 | Trigger | What happens | Deployed to |
 |---------|--------------|-------------|
 | Push to `main` | Build with base path `/dev` | [view.pathsim.org/dev/](https://view.pathsim.org/dev/) |
 | Release published | Bump `package.json`, build, deploy | [view.pathsim.org/](https://view.pathsim.org/) |
 | Manual dispatch | Choose `dev` or `release` | Respective path |
 
+### PyPI (pip package)
+
+| Trigger | What happens | Published to |
+|---------|--------------|--------------|
+| Release published | Build frontend + wheel, publish | [pypi.org/project/pathview](https://pypi.org/project/pathview/) |
+| Manual dispatch | Choose `testpypi` or `pypi` | Respective index |
+
 ### How it works
 
 1. Both versions deploy to the `deployment` branch using GitHub Actions
 
@@ -19,7 +19,8 @@
     "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
     "lint": "eslint .",
     "format": "prettier --write .",
-    "server": "python server/app.py"
+    "server": "python -m pathview_server.app",
+    "build:package": "python scripts/build_package.py"
   },
   "devDependencies": {
     "@sveltejs/adapter-static": "^3.0.0",
 
@@ -0,0 +1,3 @@
+"""PathView Server — local Flask backend for PathView."""
+
+__version__ = "0.5.0"
@@ -0,0 +1,6 @@
+"""Entry point for: python -m pathview_server"""
+
+from pathview_server.cli import main
+
+if __name__ == "__main__":
+    main()
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+"""PathView Server — local Flask backend for PathView."""`
	`2`	`+`
	`3`	`+__version__ = "0.5.0"`