Skip to content

Commit 996c5ef

Browse files
authored
Update readme and small logo (#158)
* 📝 Update small logo * 📝 Update citation.cff file * 📄 Include CCBY license for creative works on the LICENSE file and add this info in the README * 📝 Add apicall case study on the README
1 parent 07d0ac4 commit 996c5ef

File tree

5 files changed

+64
-23
lines changed

5 files changed

+64
-23
lines changed

CITATION.cff

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ preferred-citation:
2828
given-names: "Alberto"
2929
orcid: "http://orcid.org/0000-0002-9163-7730"
3030
title: "VueGen: Automating the generation of scientific reports"
31-
journal: "bioRxiv"
31+
journal: "Bioinformatics Advances"
3232
year: 2025
33-
doi: "10.1101/2025.03.05.641152"
34-
url: "https://www.biorxiv.org/content/10.1101/2025.03.05.641152v1"
33+
doi: "10.1093/bioadv/vbaf149"
34+
url: "https://doi.org/10.1093/bioadv/vbaf149"

LICENSE renamed to LICENSE.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2023 Multi-omics Network Analytics Group
3+
Copyright (c) 2025 Multi-omics Network Analytics Group
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal
@@ -19,3 +19,13 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
1919
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
2020
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
2121
SOFTWARE.
22+
23+
Creative Commons Attribution 4.0 International License (CC BY 4.0)
24+
25+
Copyright (c) 2025 Multi-omics Network Analytics Group
26+
27+
The creative works from this project are licensed under a Creative Commons Attribution
28+
4.0 International License.
29+
30+
To view a copy of this license, visit http://creativecommons.org/licenses/by/4.0/.
31+

README.md

Lines changed: 31 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
| Information | Links |
88
| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
9-
| **Package** | [![PyPI Latest Release](https://img.shields.io/pypi/v/vuegen.svg)][vuegen-pypi] [![Conda Latest Release](https://img.shields.io/conda/v/bioconda/vuegen.svg)][vuegen-conda] [![Supported versions](https://img.shields.io/pypi/pyversions/vuegen.svg)][vuegen-pypi] [![Docker Repository on Quay](https://quay.io/repository/dtu_biosustain_dsp/vuegen/status "Docker Repository on Quay")][vuegen-docker-quay] [![License](https://img.shields.io/github/license/Multiomics-Analytics-Group/vuegen)][vuegen-license] |
9+
| **Package** | [![PyPI Latest Release](https://img.shields.io/pypi/v/vuegen.svg)][vuegen-pypi] [![Conda Latest Release](https://img.shields.io/conda/v/bioconda/vuegen.svg)][vuegen-conda] [![Supported versions](https://img.shields.io/pypi/pyversions/vuegen.svg)][vuegen-pypi] [![Docker Repository on Quay](https://quay.io/repository/dtu_biosustain_dsp/vuegen/status "Docker Repository on Quay")][vuegen-docker-quay] [![License](https://img.shields.io/github/license/Multiomics-Analytics-Group/vuegen)][vuegen-license] [![CC BY 4.0][cc-by-shield]][vuegen-license]|
1010
| **Documentation** | [![View - Documentation](https://img.shields.io/badge/view-Documentation-blue?style=flat)][vuegen-docs] [![made-with-sphinx-doc](https://img.shields.io/badge/Made%20with-Sphinx-1f425f.svg)](https://www.sphinx-doc.org/) ![Docs](https://readthedocs.org/projects/vuegen/badge/?style=flat) |
1111
| **Build** | [![CI](https://github.com/Multiomics-Analytics-Group/vuegen/actions/workflows/cdci.yml/badge.svg)][ci-gh-action] [![Docs](https://github.com/Multiomics-Analytics-Group/vuegen/actions/workflows/docs.yml/badge.svg)][ci-docs] |
1212
| **Examples** | [![HTML5](https://img.shields.io/badge/html5-%23E34F26.svg?style=for-the-badge&logo=html5&logoColor=white)][emp-html-demo] [![Streamlit](https://img.shields.io/badge/Streamlit-%23FE4B4B.svg?style=for-the-badge&logo=streamlit&logoColor=white)][emp-st-demo] |
@@ -21,6 +21,7 @@
2121
- [GUI](#gui)
2222
- [Case studies](#case-studies)
2323
- [Web application deployment](#web-application-deployment)
24+
- [License](#license)
2425
- [Contributing](#contributing)
2526
- [Credits and acknowledgements](#credits-and-acknowledgements)
2627
- [Citation](#citation)
@@ -331,12 +332,24 @@ This advanced case study demonstrates the application of VueGen in a real-world
331332
> The EMP case study is available online as [HTML][emp-html-demo] and [Streamlit][emp-st-demo] reports.
332333
> The [configuration file][emp-config] is available in the `docs/example_config_files` folder, and the [directory][emp-dir] with example data is in the `docs/example_data` folder.
333334
334-
### 3. ChatBot Component
335+
### 3. APICall Component
336+
337+
This case study focuses on the `APICall` component, which enables interaction with external APIs by using HTTP methods such as **GET** and **POST**. The retrieved data is displayed in the report, allowing users to integrate external data sources into their anlyses. This component is restricted to **Streamlit** reports.
338+
339+
🔗 [![Open in Colab][colab_badge]][colab_link_apicall]
340+
341+
> [!NOTE]
342+
> A [configuration file example][apicall-config] for the apicall component is available in
343+
the `docs/example_config_files` folder.
344+
345+
### 4. ChatBot Component
335346

336347
This case study highlights VueGen’s capability to embed a chatbot component into a report subsection,
337348
enabling interactive conversations inside the report. This component is streamlit-specific and is not
338349
available for other report types.
339350

351+
🔗 [![Open in Colab][colab_badge]][colab_link_chatbot]
352+
340353
Two API modes are supported:
341354

342355
- **Ollama-style streaming chat completion:**
@@ -355,11 +368,11 @@ Two API modes are supported:
355368
- `links`: a list of source URLs (optional)
356369
- `HTML content`: an HTML snippet with a Pyvis network visualization (optional)
357370

358-
This response structure is currently customized for an internal knowledge graph assistant, but VueGen is being actively developed
359-
to support more flexible and general-purpose response formats in future releases.
371+
This response structure is currently customized for an internal knowledge graph assistant, but VueGen is being actively developed to support more flexible and general-purpose response formats in future releases.
360372

361373
> [!NOTE]
362-
> You can see a [configuration file example][config-chatbot] for the chatbot component in the `docs/example_config_files` folder.
374+
> A [configuration file example][chatbot-config] for the chatbot component is available
375+
in the `docs/example_config_files` folder.
363376

364377
## Web application deployment
365378

@@ -379,6 +392,14 @@ Run Streamlit apps directly in the browser with [stlite][stlite_repo], a WebAsse
379392

380393
These options provide flexibility depending on whether the goal is online accessibility, lightweight execution, or local application distribution.
381394

395+
## License
396+
397+
The code in this repository is licensed under the **MIT License**, allowing you to use, modify, and distribute it freely as long as you include the original copyright and license notice.
398+
399+
The documentation and other creative content are licensed under the **Creative Commons Attribution 4.0 International (CC BY 4.0) License**, meaning you are free to share and adapt it with proper attribution.
400+
401+
Full details for both licenses can be found in the [LICENSE][vuegen-license] file.
402+
382403
## Contributing
383404

384405
VueGen is an open-source project, and we welcome contributions of all kinds via GitHub issues and pull requests. You can report bugs, suggest improvements, propose new features, or implement changes. Please follow the guidelines in the [CONTRIBUTING](CONTRIBUTING.md) file to ensure that your contribution is easily integrated into the project.
@@ -425,6 +446,7 @@ We appreciate your feedback! If you have any comments, suggestions, or run into
425446
[vuegen-docker-quay]: https://quay.io/repository/dtu_biosustain_dsp/vuegen
426447
[docker-folder]: https://github.com/Multiomics-Analytics-Group/nf-vuegen/tree/main/Docker
427448
[vuegen-license]: https://github.com/Multiomics-Analytics-Group/vuegen/blob/main/LICENSE
449+
[cc-by-shield]: https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg
428450
[vuegen-class-diag-att]: https://raw.githubusercontent.com/Multiomics-Analytics-Group/vuegen/main/docs/images/vuegen_classdiagram_withattmeth.pdf
429451
[vuegen-docs]: https://vuegen.readthedocs.io/
430452
[ci-gh-action]: https://github.com/Multiomics-Analytics-Group/vuegen/actions/workflows/cdci.yml
@@ -433,7 +455,6 @@ We appreciate your feedback! If you have any comments, suggestions, or run into
433455
[emp-st-demo]: https://earth-microbiome-vuegen-demo.streamlit.app/
434456
[ollama_chat]: https://github.com/ollama/ollama/blob/main/docs/api.md#generate-a-chat-completion
435457
[ollama]: https://ollama.com/
436-
[config-chatbot]: https://github.com/Multiomics-Analytics-Group/vuegen/blob/main/docs/example_config_files/Chatbot_example_config.yaml
437458
[issues]: https://github.com/Multiomics-Analytics-Group/vuegen/issues
438459
[pulls]: https://github.com/Multiomics-Analytics-Group/vuegen/pulls
439460
[vuegen-article]: https://doi.org/10.1093/bioadv/vbaf149
@@ -452,6 +473,10 @@ We appreciate your feedback! If you have any comments, suggestions, or run into
452473
[emp]: https://earthmicrobiome.org/
453474
[emp-config]: https://github.com/Multiomics-Analytics-Group/vuegen/blob/main/docs/example_config_files/Earth_microbiome_vuegen_demo_notebook_config
454475
[emp-dir]: https://github.com/Multiomics-Analytics-Group/vuegen/blob/main/docs/example_data/Earth_microbiome_vuegen_demo_notebook
476+
[colab_link_apicall]: https://colab.research.google.com/github/Multiomics-Analytics-Group/vuegen/blob/main/docs/vuegen_apicall_case_study.ipynb
477+
[apicall-config]: https://github.com/Multiomics-Analytics-Group/vuegen/blob/main/docs/example_config_files/APIcall_example_config.yaml
478+
[colab_link_chatbot]: https://colab.research.google.com/github/Multiomics-Analytics-Group/vuegen/blob/main/docs/vuegen_chatbot_case_study.ipynb
479+
[chatbot-config]: https://github.com/Multiomics-Analytics-Group/vuegen/blob/main/docs/example_config_files/Chatbot_example_config.yaml
455480
[conda-download]: https://conda-forge.org/download/
456481
[gui-readme]: https://github.com/Multiomics-Analytics-Group/vuegen/blob/main/gui/README.md
457482
[pyinstaller]: https://pyinstaller.org/
60 Bytes
Loading

0 commit comments

Comments
 (0)