✨ lumen-anndata
https://github.com/user-attachments/assets/466b8310-70a7-45d6-8e32-5cf60011c7b8
Overview
lumen-anndata is an extension to enable Lumen to interact with anndata objects, a common format for single-cell genomics data. It aims to allow researchers to use natural language to explore, analyze, and visualize complex single-cell datasets through a chat interface.
Features
lumen-anndata supports the following capabilities:
- Natural language querying of anndata objects
- Integration with select scanpy functions for running analysis and static plotting
- Interactive visualization of single-cell data (UMAP, DotMap, HeatMap, Dendrogram, etc.) with HoloViz
Installation
Install it via pip:
pip install lumen-anndata
Usage
To launch the Lumen app, run:
lumen-anndata
Development
git clone https://github.com/holoviz-topics/lumen-anndata
cd lumen-anndata
For a simple setup use uv:
uv venv
source .venv/bin/activate # on linux. Similar commands for windows and osx
uv pip install -e .[dev]
uv pip install "git+https://github.com/holoviz/lumen@main#egg=lumen[ai-llama]"
pre-commit run
pytest tests
For the full Github Actions setup use pixi:
pixi run pre-commit-install
pixi run postinstall
pixi run test
This repository is adapted from copier-template-panel-extension
To update to the latest template version run:
pixi exec --spec copier --spec ruamel.yaml -- copier update --defaults --trust
Note: copier will show Conflict for files with manual changes during an update. This is normal. As long as there are no merge conflict markers, all patches applied cleanly.
To update the embeddings to use a new version of scanpy, increment the version in scripts/embed_docs.py and run:
python scripts/embed_docs.py
Ensure you have an OpenAI API key set in your environment variables. You can set it in your terminal session with:
export OPENAI_API_KEY="sk-..."
❤️ Contributing
Contributions are welcome! Please follow these steps to contribute:
- Fork the repository.
- Create a new branch:
git checkout -b feature/YourFeature. - Make your changes and commit them:
git commit -m 'Add some feature'. - Push to the branch:
git push origin feature/YourFeature. - Open a pull request.
Please ensure your code adheres to the project's coding standards and passes all tests.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
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
File details
Details for the file lumen_anndata-0.1.0.tar.gz.
File metadata
- Download URL: lumen_anndata-0.1.0.tar.gz
- Upload date:
- Size: 2.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b46b622bb81a2fe8d1a1e24fbea5a4ab332ba0d673bd489540b5d41d0f0ab661
|
|
| MD5 |
5f3334ad24eef55e32dfd4c8ca0003c6
|
|
| BLAKE2b-256 |
62b07f60f91863dcdb99ab4ef155d39f81da075907e73bca4e87381496709103
|
Provenance
The following attestation bundles were made for lumen_anndata-0.1.0.tar.gz:
Publisher:
build.yaml on holoviz-topics/lumen-anndata
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lumen_anndata-0.1.0.tar.gz -
Subject digest:
b46b622bb81a2fe8d1a1e24fbea5a4ab332ba0d673bd489540b5d41d0f0ab661 - Sigstore transparency entry: 2284498351
- Sigstore integration time:
-
Permalink:
holoviz-topics/lumen-anndata@9d387ebc5afce579dda64a82f2e6a8ee5ecf8c47 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/holoviz-topics
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
build.yaml@9d387ebc5afce579dda64a82f2e6a8ee5ecf8c47 -
Trigger Event:
push
-
Statement type:
File details
Details for the file lumen_anndata-0.1.0-py3-none-any.whl.
File metadata
- Download URL: lumen_anndata-0.1.0-py3-none-any.whl
- Upload date:
- Size: 2.5 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0d3bcb163a7388fa628ac4dd8f881b6a7c9e7aa536538e485fc1bd351a2fe021
|
|
| MD5 |
c1e0f4cad223fb4945cd21ff898718ff
|
|
| BLAKE2b-256 |
2b0f9c6c6bc92d815e5fd7eac506581e97d10058e557f895667828f57ff08384
|
Provenance
The following attestation bundles were made for lumen_anndata-0.1.0-py3-none-any.whl:
Publisher:
build.yaml on holoviz-topics/lumen-anndata
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lumen_anndata-0.1.0-py3-none-any.whl -
Subject digest:
0d3bcb163a7388fa628ac4dd8f881b6a7c9e7aa536538e485fc1bd351a2fe021 - Sigstore transparency entry: 2284498401
- Sigstore integration time:
-
Permalink:
holoviz-topics/lumen-anndata@9d387ebc5afce579dda64a82f2e6a8ee5ecf8c47 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/holoviz-topics
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
build.yaml@9d387ebc5afce579dda64a82f2e6a8ee5ecf8c47 -
Trigger Event:
push
-
Statement type:
