💡 The Philosophy

Extremely simple on the surface. Extremely powerful underneath.

Darsh is designed to make Data Analytics feel less like writing boilerplate code and more like creating a premium modern product.

You should not feel like you are using FastAPI, Pandas, SVG, JavaScript, or CSS. Darsh absorbs all that complexity so you can focus entirely on your data and insights.

Three lines of code → Data → Analysis → Beautiful Interactive Web Application.

🚀 Quickstart

1. Install Darsh

pip install darsh

2. Build your first Dashboard

You don't need to manually design layouts, configure charts, or write HTML. Just load your data and let Darsh do the magic.

Create a file named app.py:

import darsh as da
import pandas as pd

# 1. Load your data (CSV, Excel, or DataFrame)
df = pd.read_csv("https://raw.githubusercontent.com/datasciencedojo/datasets/master/titanic.csv")

# 2. Let Darsh intelligently clean it and wrap it
data = da.data(df).clean()

# 3. Generate a magical interactive dashboard
da.initialize(title="Titanic Analytics")
da.dashboard(data)

# 4. Run the server!
if __name__ == "__main__":
    da.get_app().run(port=8501)

3. Run it

python app.py

Visit http://localhost:8501 in your browser to see your premium, interactive dashboard!

✨ Features

• 🧠 Intelligent Dashboards: Call da.dashboard(data) and Darsh will automatically infer data types and generate KPI cards, Line Charts for dates, and Bar Charts for categories.
• ⚡ Instant Cross-Filtering: Click on any chart element (like a bar in a Bar Chart) and watch the entire dashboard instantly filter and recalculate in the browser. No server roundtrips required!
• 🎨 Buttery Smooth Animations: SVG elements fluidly morph and transition when data is filtered.
• 🛡️ Zero Frontend Knowledge Required: Darsh compiles your Python code into a secure JSON Abstract Syntax Tree (AST), which is natively rendered by our custom lightweight JavaScript engine.
• 🧹 Smart Data Cleaning: data.clean() automatically handles duplicates, missing values, and infers datetime objects so you don't have to wrestle with Pandas.

👨‍💻 Creator

Darsh was created and designed by Satyam Rana, a Full-Stack Engineer, AI Practitioner, and Educator passionate about the intersections of technology, science, and meaningful innovation.

📄 License

This project is licensed under the MIT License.