Introduction
Shellviz is the missing visual logger for your development workflow. While your code runs in the terminal or server, Shellviz streams the data to your browser in real-time – creating an instant, interactive debugging and monitoring companion.
No dashboards to configure. No services to deploy. No dependencies to manage. Just add one import and transform raw data into charts, tables, progress bars, and more. It's like having a data scientist's notebook built into your print statements.
Want to see it in action? Click the "Run Example" button to see your first Shellviz call in action:
from shellviz import log, table, json
log("my first shellviz command")
# Shellviz serving on http://192.168.86.124:5544
table([("Alice", 25, 5.6), ("Bob", 30, 5.9), ("Charlie", 22, 5.7)])
json({"name": "Alice", "age": 25, "height": 5.6})
import { log, table, json } from 'shellviz';
log('hello from Node.js');
table([['Name', 'Age'], ['Alice', 30], ['Bob', 25]]);
json({ message: 'JavaScript visualization!' });
<script src="https://unpkg.com/shellviz"></script>
<script>
const { log, show } = shellviz;
show(); // Display floating widget
log('hello from the browser');
</script>
Shellviz seamlessly integrates with your favorite frameworks and languages. Choose the integration that best fits your development workflow.
Django
Integrate Shellviz with Django applications. Perfect for debugging views, middleware, and Django ORM queries.
Javascript
Run Shellviz directly in the browser. No server required - perfect for static sites and frontend debugging.
Python
Native Python integration for scripts, notebooks, and applications. Debug and visualize data with minimal setup.
Node.js / Next.js / React
Full-stack JavaScript support. Debug server-side Node.js code and React components with ease.
Features
- Cross-Platform Support: Available for Python, Node.js, and browser environments with identical APIs
- Free and Easy to Use: Shellviz is completely free and requires no configuration, sign-up, or API key. Just install the package, and you're ready to go!
- Dynamic Data Manipulation:
- Update Existing Values: Modify your data on the fly without cluttering your output
- Append to Values: Add new data to your existing logs to keep everything organized
- Clear Logs Programmatically: Reset your log with a single command for a fresh start
- View Multiple Data Sources at Once: Visualize and manage multiple data sources side-by-side in the Shellviz canvas
- Powerful Data Visualizations:
- Supports charts, tables, cards, maps, progress bars, and more
- Easily turn complex data structures (JSON, dictionaries, lists) into digestible visuals
- Perfect for exploring and analyzing large datasets
- Search, slice, and filter JSON objects or export your data as downloadable CSV files
- Break down complex or hard-to-read terminal output and focus on insights. Shellviz makes data exploration intuitive and efficient
- Interactive Second Screen: Use your phone as a second screen for real-time data exploration. Simply scan the QR code generated by Shellviz to pair your phone and visualize data instantly