Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Lumen

Illuminate your data

Build Status Linux/MacOS/Windows Build Status
Coverage codecov
Latest dev release Github tag dev-site
Latest release Github release PyPI version lumen version conda-forge version defaults version
Docs gh-pages site
Support Discourse

Why Lumen?

The Lumen project consists of two main pieces:

  • Lumen Core: A framework for visual analytics, making it possible to build complex data processing pipelines, plots and entire dashboards using a declarative specification.
  • Lumen AI: An extensible Agent based "chat-with-data" framework.

Together these pieces make it possible to perform complex data analysis using natural language, and then export the results, continue the analysis in a notebook or assemble the results into a dashboard using a drag-and-drop interface.

Lumen AI

Lumen AI Diagram

Lumen AI provides a framework for chatting with data. It interfaces with the Lumen data sources providing the ability to connect with your database or data lake and unlock insights without writing code.

  • Generate complex SQL queries to analyze the data
  • Generate charts & powerful data tables or entire dashboards.
  • Automatically summarize the key results and insights.
  • Define custom analyses to generate deep insights tailored to your domain.

Lumen Core

The power of Lumen comes from the ability to leverage the powerful data intake, data processing and data visualization libraries available in the PyData ecosystem.

  • Data Intake: A flexible system for declaring data sources with strong integration with SQL, DuckDB and familiar Python DataFrame libraries. This allows Lumen to query data from a wide range of sources including many file formats such as CSV or Parquet but also SQL and many others and apply transformations where the data lives.
  • Data Proccessing: Internally Lumen allows manipulating data in SQL or in Python as DataFrame objects. This allows Lumen to perform data transformations where the data lives (using SQL), while also providing the flexibility of familiar APIs for filtering and transforming data using Pandas or scaling these transformations out to a cluster thanks to Dask.
  • Data Visualization: Since Lumen is built on Panel all the most popular plotting libraries and many other components such as powerful datagrids and BI indicators are supported.

The core strengths of Lumen include:

  • Flexibility: The design of Lumen allows flexibly combining data intake, data processing and data visualization into a simple declarative pipeline.
  • Extensibility: Every part of Lumen is designed to be extended letting you define custom Source, Filter, Transform and View components.
  • Scalability: Lumen is designed with performance in mind and supports scalable Dask DataFrames out of the box, letting you scale to datasets larger than memory or even scale out to a cluster.
  • Security: Lumen ships with a wide range of OAuth providers out of the box, making it a breeze to add authentication to your applications.

Getting started

Lumen works with Python 3 and above on Linux, Windows, or Mac. The recommended way to install Lumen is using the conda command provided by Anaconda or Miniconda:

conda install -c pyviz lumen

or using PyPI:

pip install lumen[ai]

Once installed you will be able to start a Lumen server by running:

lumen serve dashboard.yaml --show

This will open a browser serving the application or dashboard declared by your yaml file in a browser window. During development it is very helpful to use the --autoreload flag, which will automatically refresh and update the application in your browser window, whenever you make an edit to the dashboard yaml specification. In this way you can quickly iterate on your dashboard.

Try it out! Click on one of the examples below, copy the yaml specification and launch your first Lumen application.

Metadata

Release files for lumen 0.7.0b4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lumen 0.7.0b4
File Size Uploaded
lumen-0.7.0b4.tar.gz 466.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for lumen 0.7.0b4
File Interpreter ABI Platform
lumen-0.7.0b4-py3-none-any.whl Python 3 none any Details

Total release size: 990.3 kB

Release files / lumen-0.7.0b4.tar.gz

Download URL lumen-0.7.0b4.tar.gz
Size 466.7 kB
Tags Source
SHA-256 checksum
How to use checksums
3e1b958a76bc328ea114458efbc25d6cb5dad418d9cbdc3a4dc80e9ef1b46ea8
BLAKE2b-256 checksum
How to use checksums
568ffbe237c1bf63c58e055297344ee09a4f4a28ef737d8e9183df2ffcbf4f1f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.12.7

Release files / lumen-0.7.0b4-py3-none-any.whl

Download URL lumen-0.7.0b4-py3-none-any.whl
Size 523.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b20ba2568f0ef67b14469b577027032be143f0d278380051b6d5ee63573f1ffd
BLAKE2b-256 checksum
How to use checksums
2ab54d8ffefbd92c7be1f05c369fd2a3ae2c2682ab2fa3d562cc5f2fd4c89dc2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.12.7

Release history Release notifications | RSS feed

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.10.0

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.0

2 release files

This release

0.7.0b4 This release

2 release files

0.6.3

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page