esparto

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 90 Open GitHub ↗

Data driven report builder for the Python data ecosystem.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**esparto** is a Python library for building data driven reports with content
from popular analytics packages.

- [Documentation][ProjectHome]
- [Source Code][GitHub]
- [Contributing](#contributions-issues-and-requests)
- [Bug Reports][Issues]

Main Features
-------------

- Create beautiful analytical reports using idiomatic Python
- Generate content from:
    - [Markdown][Markdown]
    - [Pandas DataFrames][Pandas]
    - [Matplotlib][Matplotlib]
    - [Bokeh][Bokeh]
    - [Plotly][Plotly]
- Develop interactively with [Jupyter Notebooks][Jupyter]
- Share documents as a self-contained webpage or PDF
- Customise with [CSS][CSS] and [Jinja][Jinja]
- Responsive [Bootstrap][Bootstrap] layout

Basic Usage
-----------

```python
import esparto as es

# Do some analysis
pandas_df = ...
plot_fig = ...
markdown_str = ...

# Create a page
page = es.Page(title="My Report")

# Add content
page["Data Analysis"]["Plot"] = plot_fig
page["Data Analysis"]["Data"] = pandas_df
page["Data Analysis"]["Notes"] = markdown_str

# Save to HTML or PDF
page.save_html("my-report.html")
page.save_pdf("my-report.pdf")

```

Installation
------------

**esparto** is available from [PyPI][PyPI] and [Conda][Conda]:

```bash
pip install esparto
```

```bash
conda install esparto -c conda-forge
```

```bash
poetry add esparto
```

Dependencies
------------

- [python](https://python.org/) >= 3.6
- [jinja2](https://palletsprojects.com/p/jinja/)
- [markdown](https://python-markdown.github.io/)
- [BeautifulSoup](https://www.crummy.com/software/BeautifulSoup/)
- [PyYAML](https://pyyaml.org/)

#### Optional

- [weasyprint](https://weasyprint.org/) *(for PDF output)*

License
-------

[MIT](https://opensource.org/licenses/MIT)

Documentation
-------------

User guides, documentation, and examples are available on the [project home page][ProjectHome].

Contributions, Issues, and Requests
-----------------------------------

Feedback and contributions are welcome - please raise an issue or pull request
on [GitHub][GitHub].

Examples
--------

Iris Report - [Webpage](https://domvwt.github.io/esparto/examples/iris-report.html) |
[PDF](https://domvwt.github.io/esparto/examples/iris-report.pdf) | [Notebook](https://github.com/domvwt/esparto/blob/main/docs/examples/iris-report.ipynb)

<br>

[ProjectHome]: https://domvwt.github.io/esparto/
[PyPI]: https://pypi.org/project/esparto/
[Conda]: https://anaconda.org/conda-forge/esparto
[Bootstrap]: https://getbootstrap.com/
[Jinja]: https://jinja.palletsprojects.com/
[CSS]: https://developer.mozilla.org/en-US/docs/Web/CSS
[Markdown]: https://www.markdownguide.org/
[Pandas]: https://pandas.pydata.org/
[Matplotlib]: https://matplotlib.org/
[Bokeh]: https://bokeh.org/
[Plotly]: https://plotly.com/
[Jupyter]: https://jupyter.org/
[GitHub]: https://github.com/domvwt/esparto
[Issues]: https://github.com/domvwt/esparto/issues

esparto

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README