Fork of Eel with Vite HMR support for modern web development
Project description
Vit3l
Vit3l is a fork of Eel that adds support for external web servers, enabling modern development workflows with Vite HMR (Hot Module Replacement).
What's New
- External URL Support: Connect to any external web server (Vite, Webpack, etc.)
- Vite HMR: Full support for Hot Module Replacement
- Modern Development: Use TypeScript, SCSS, PostCSS, and other modern tools
- Backward Compatible: All existing Eel functionality preserved
- WebSocket Communication: Python ↔ JavaScript communication via WebSocket
📦 Installation
Using pip
pip install Vit3l
Using uv (recommended)
uv add Vit3l
With Jinja2 templates
pip install Vit3l[jinja2]
# or
uv add "Vit3l[jinja2]"
🎯 Quick Start
Traditional Eel (still works)
import vit3l as eel
eel.init('web')
eel.start('index.html') # Runs on localhost:8000
New: External URL Mode
import vit3l as eel
@eel.expose
def say_hello(name):
return f'Hello {name}!'
eel.init('web')
eel.start('http://localhost:5173', external_url='http://localhost:5173')
JavaScript (same as Eel)
const result = await eel.say_hello("World")();
console.log(result); // "Hello World!"
Vite Integration
1. Setup Vite project
npm create vite@latest my-eel-app
cd my-eel-app
npm install
2. Configure Vite (vite.config.js)
import { defineConfig } from "vite";
export default defineConfig({
server: {
port: 5173,
cors: true,
},
});
3. Add Eel to HTML
<!DOCTYPE html>
<html>
<head>
<title>Vite + Vit3l</title>
</head>
<body>
<h1>Hello from Vite + Vit3l!</h1>
<button onclick="callPython()">Call Python</button>
<!-- Connect to Eel WebSocket server -->
<script src="http://localhost:8000/eel.js"></script>
<script>
function callPython() {
eel.say_hello("from Vite!")();
}
</script>
</body>
</html>
4. Python script
import vit3l as eel
@eel.expose
def say_hello(message):
print(f"Hello {message}")
return f"Python received: {message}"
eel.init('src') # Your Vite source folder
eel.start('http://localhost:5173', external_url='http://localhost:5173')
5. Run both servers
# Terminal 1: Vite dev server
npm run dev
# Terminal 2: Python script
python app.py
Examples
# External URL with custom settings
eel.start(
'http://localhost:5173',
external_url='http://localhost:5173',
mode='chrome',
port=8000,
block=True
)
# Multiple URLs
eel.start(
'http://localhost:5173',
'http://localhost:3000',
external_url='http://localhost:5173'
)
External URL Mode
- Vite Server: Serves static files with HMR on port 5173
- Eel WebSocket Server: Runs on port 8000 for Python ↔ JavaScript communication
- Browser: Connects to both servers
- Result: Modern development with full Eel functionality
Troubleshooting
WebSocket Connection Issues
// Check WebSocket status in browser console
console.log("WebSocket state:", eel._websocket.readyState);
// 0 = CONNECTING, 1 = OPEN, 2 = CLOSING, 3 = CLOSED
CORS Errors
Ensure Vite is configured with CORS enabled:
// vite.config.js
export default defineConfig({
server: {
cors: true,
},
});
Port Conflicts
Change Eel WebSocket port if 8000 is occupied:
eel.start('http://localhost:5173', external_url='http://localhost:5173', port=8001)
License
MIT License - see LICENSE file for details.
Acknowledgments
- Original Eel project by Chris Knott
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
vit3l-0.22.0.tar.gz
(23.0 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
vit3l-0.22.0-py3-none-any.whl
(22.9 kB
view details)
File details
Details for the file vit3l-0.22.0.tar.gz.
File metadata
- Download URL: vit3l-0.22.0.tar.gz
- Upload date:
- Size: 23.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4d95f47c9456a9e77591646ee5bc7b72d7e3cc1fce5abf95667a5e56b8c8537a
|
|
| MD5 |
04a5917cb7444a4957dce2a6cd5f07fa
|
|
| BLAKE2b-256 |
82744f94edf6fdb64c2cd7093fb9ef855eb50751535ba970270d30f92cf025d9
|
File details
Details for the file vit3l-0.22.0-py3-none-any.whl.
File metadata
- Download URL: vit3l-0.22.0-py3-none-any.whl
- Upload date:
- Size: 22.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
68bb342f6de1e64135638011b0096c2b648b375b6ee94986494899b188bb5850
|
|
| MD5 |
ac9c7fd2e096cca9b6d7ad6c544d86ed
|
|
| BLAKE2b-256 |
373d0b6c8e75d982101a2e41955bd1cc83b3fb9d542fbfef02189e282f567969
|
