Skip to content

Commit

Permalink
Merge pull request #152 from SylphAI-Inc/main
Browse files Browse the repository at this point in the history
[Update Documentation Release]
  • Loading branch information
Alleria1809 committed Jul 23, 2024
2 parents 92d4fea + b35774c commit 4f67642
Show file tree
Hide file tree
Showing 11 changed files with 600 additions and 170 deletions.
10 changes: 8 additions & 2 deletions .github/workflows/documentation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,13 @@ jobs:
run: |
cd docs
poetry config virtualenvs.create false # Avoid creating a virtual environment
poetry install # Install only the doc dependencies as specified in pyproject.toml
poetry install --with doc # Install dependencies as specified in pyproject.toml
pip install nest-asyncio # manually install nest-asyncio
pip install torch # manually install torch
# pip install transformers # manually install transformers
poetry show
poetry show lightrag
- name: Build documentation using Makefile
run: |
Expand Down Expand Up @@ -72,4 +78,4 @@ jobs:
# pwd # Print the current working directory
# ls -l ./build/ # List files in the build directory
# cat ./source/conf.py # Display the Sphinx configuration file
# working-directory: ${{ github.workspace }}/docs/build
# working-directory: ${{ github.workspace }}/docs/build
56 changes: 42 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,35 @@
![LightRAG Logo](https://raw.githubusercontent.com/SylphAI-Inc/LightRAG/main/docs/source/_static/images/LightRAG-logo-doc.jpeg)

<!-- <h4 align="center">
<img alt="AdalFlow logo" src="docs/source/_static/images/adalflow-logo.png" style="width: 100%;">
</h4> -->

<h4 align="center">
<img alt="AdalFlow logo" src="https://raw.githubusercontent.com/SylphAI-Inc/LightRAG/main/docs/source/_static/images/adalflow-logo.png" style="width: 100%;">
</h4>


<p align="center">
<a href="https://colab.research.google.com/drive/1TKw_JHE42Z_AWo8UuRYZCO2iuMgyslTZ?usp=sharing">
<img alt="Try Quickstart in Colab" src="https://colab.research.google.com/assets/colab-badge.svg">
</a>
</p>

<h4 align="center">
<p>
<a href="https://lightrag.sylph.ai/">Documentation</a> |
<a href="https://lightrag.sylph.ai/apis/components/components.model_client.html">Models</a> |
<a href="https://lightrag.sylph.ai/apis/components/components.retriever.html">Retrievers</a> |
<a href="https://lightrag.sylph.ai/apis/components/components.agent.html">Agents</a>
<p>
</h4>

<p align="center">
<a href="https://pypi.org/project/lightRAG">
<img alt="PyPI Version" src="https://img.shields.io/pypi/v/lightRAG?style=flat-square">
</a>
<a href="https://star-history.com/#SylphAI-Inc/LightRAG">
<img alt="GitHub stars" src="https://img.shields.io/github/stars/SylphAI-Inc/LightRAG?style=flat-square">
</a>
<a href="https://pypistats.org/packages/lightrag">
<img alt="PyPI Downloads" src="https://img.shields.io/pypi/dm/lightRAG?style=flat-square">
</a>
<a href="https://github.com/SylphAI-Inc/LightRAG/issues">
<img alt="Open Issues" src="https://img.shields.io/github/issues-raw/SylphAI-Inc/LightRAG?style=flat-square">
</a>
Expand All @@ -33,22 +47,34 @@
<img alt="Try Quickstart in Colab" src="https://colab.research.google.com/assets/colab-badge.svg">
</a> -->

<!-- <a href="https://pypistats.org/packages/lightrag">
<img alt="PyPI Downloads" src="https://img.shields.io/pypi/dm/lightRAG?style=flat-square">
</a> -->



<h1>
<p align="center">
AdalFlow: The Library for Large Language Model Applications
</p>
</h1>

AdalFlow helps developers build and optimize LLM task pipelines.
Embracing similar design pattern to PyTorch, AdalFlow is light, modular, and robust, with a 100% readable codebase.

### ⚡ The Lightning Library for Large Language Model Applications ⚡
Note: We are in the progress of renaming to adalflow from lightrag.

*LightRAG* helps developers build and optimize *Retriever-Agent-Generator* pipelines.
Embracing similar design pattern to *PyTorch*, LightRAG is *light*, *modular*, and *robust*, with a 100% readable codebase.
# AdalFlow: A Tribute to Ada Lovelace

AdalFlow is named in honor of [Ada Lovelace](https://en.wikipedia.org/wiki/Ada_Lovelace), the pioneering female mathematician who first recognized that machines could do more than just calculations. As a female-led team, we aim to inspire more women to enter the AI field.

# Why LightRAG?
# Why AdalFlow?

LLMs are like water; they can be shaped into anything, from GenAI applications such as chatbots, translation, summarization, code generation, and autonomous agents to classical NLP tasks like text classification and named entity recognition. They interact with the world beyond the model’s internal knowledge via retrievers, memory, and tools (function calls). Each use case is unique in its data, business logic, and user experience.

Because of this, no library can provide out-of-the-box solutions. Users must build towards their own use case. This requires the library to be modular, robust, and have a clean, readable codebase. The only code you should put into production is code you either 100% trust or are 100% clear about how to customize and iterate.

<!-- This is what LightRAG is: light, modular, and robust, with a 100% readable codebase. -->
<!-- This is what AdalFlow is: light, modular, and robust, with a 100% readable codebase. -->


Further reading: [How We Started](https://www.linkedin.com/posts/li-yin-ai_both-ai-research-and-engineering-use-pytorch-activity-7189366364694892544-Uk1U?utm_source=share&utm_medium=member_desktop),
Expand Down Expand Up @@ -81,7 +107,7 @@ class Net(nn.Module):
x = self.fc1(x)
return self.fc2(x)
``` -->
# LightRAG Task Pipeline
# AdalFlow Task Pipeline

We will ask the model to respond with ``explanation`` and ``example`` of a concept. To achieve this, we will build a simple pipeline to get the structured output as ``QAOutput``.

Expand Down Expand Up @@ -254,7 +280,7 @@ self.generator = Generator(

# Quick Install

Install LightRAG with pip:
Install AdalFlow with pip:

```bash
pip install lightrag
Expand All @@ -267,13 +293,15 @@ Please refer to the [full installation guide](https://lightrag.sylph.ai/get_star

# Documentation

LightRAG full documentation available at [lightrag.sylph.ai](https://lightrag.sylph.ai/):
AdalFlow full documentation available at [lightrag.sylph.ai](https://lightrag.sylph.ai/):
- [How We Started](https://www.linkedin.com/posts/li-yin-ai_both-ai-research-and-engineering-use-pytorch-activity-7189366364694892544-Uk1U?utm_source=share&utm_medium=member_desktop)
- [Introduction](https://lightrag.sylph.ai/)
- [Full installation guide](https://lightrag.sylph.ai/get_started/installation.html)
- [Design philosophy](https://lightrag.sylph.ai/tutorials/lightrag_design_philosophy.html)
- [Class hierarchy](https://lightrag.sylph.ai/tutorials/class_hierarchy.html)
- [Tutorials](https://lightrag.sylph.ai/tutorials/index.html)
- [Supported Models](https://lightrag.sylph.ai/apis/components/components.model_client.html)
- [Supported Retrievers](https://lightrag.sylph.ai/apis/components/components.retriever.html)
- [API reference](https://lightrag.sylph.ai/apis/index.html)


Expand All @@ -286,9 +314,9 @@ LightRAG full documentation available at [lightrag.sylph.ai](https://lightrag.sy
# Citation

```bibtex
@software{Yin2024LightRAG,
@software{Yin2024AdalFlow,
author = {Li Yin},
title = {{LightRAG: The Lightning Library for Large Language Model (LLM) Applications}},
title = {{AdalFlow: The Library for Large Language Model (LLM) Applications}},
month = {7},
year = {2024},
doi = {10.5281/zenodo.12639531},
Expand Down
Loading

0 comments on commit 4f67642

Please sign in to comment.