Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/leptonai/leptonai
A Pythonic framework to simplify AI service building
https://github.com/leptonai/leptonai
artificial-intelligence cloud deep-learning gpu machine-learning python
Last synced: 1 day ago
JSON representation
A Pythonic framework to simplify AI service building
- Host: GitHub
- URL: https://github.com/leptonai/leptonai
- Owner: leptonai
- License: apache-2.0
- Created: 2023-09-06T20:38:00.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-27T20:22:11.000Z (16 days ago)
- Last Synced: 2024-12-04T15:07:17.181Z (9 days ago)
- Topics: artificial-intelligence, cloud, deep-learning, gpu, machine-learning, python
- Language: Python
- Homepage: https://lepton.ai/
- Size: 4.85 MB
- Stars: 2,663
- Watchers: 23
- Forks: 172
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- AiTreasureBox - leptonai/leptonai - 12-07_2664_0](https://img.shields.io/github/stars/leptonai/leptonai.svg)|A Pythonic framework to simplify AI service building| (Repos)
- ai-game-devtools - Lepton AI
- awesome-production-machine-learning - Lepton AI - LeptonAI Python library allows you to build an AI service from Python code with ease. (Deployment and Serving)
- StarryDivineSky - leptonai/leptonai - U leptonai` 安装 Lepton AI,并使用 `lep photon runlocal` 命令启动 HuggingFace 模型。Lepton AI 还提供托管的模型和 API 访问,以及丰富的示例和文档。 (A01_文本生成_文本对话 / 大语言对话模型及数据)
README
# Lepton AI
**A Pythonic framework to simplify AI service building**
Homepage •
API Playground •
Examples •
Documentation •
CLI References •
Twitter •
BlogThe LeptonAI Python library allows you to build an AI service from Python code with ease. Key features include:
- A Pythonic abstraction `Photon`, allowing you to convert research and modeling code into a service with a few lines of code.
- Simple abstractions to launch models like those on [HuggingFace](https://huggingface.co) in few lines of code.
- Prebuilt examples for common models such as Llama, SDXL, Whisper, and others.
- AI tailored batteries included such as autobatching, background jobs, etc.
- A client to automatically call your service like native Python functions.
- Pythonic configuration specs to be readily shipped in a cloud environment.## Getting started with one-liner
Install the library with:```shell
pip install -U leptonai
```
This installs the `leptonai` Python library, as well as the commandline interface `lep`. You can then launch a HuggingFace model, say `gpt2`, in one line of code:```python
lep photon runlocal --name gpt2 --model hf:gpt2
```If you have access to the Llama2 model ([apply for access here](https://huggingface.co/meta-llama/Llama-2-7b)) and you have a reasonably sized GPU, you can launch it with:
```python
# hint: you can also write `-n` and `-m` for short
lep photon runlocal -n llama2 -m hf:meta-llama/Llama-2-7b-chat-hf
```(Be sure to use the `-hf` version for Llama2, which is compatible with huggingface pipelines.)
You can then access the service with:
```python
from leptonai.client import Client, local
c = Client(local(port=8080))
# Use the following to print the doc
print(c.run.__doc__)
print(c.run(inputs="I enjoy walking with my cute dog"))
```Fully managed Llama2 models and CodeLlama models can be found in the [playground](https://dashboard.lepton.ai/playground).
Many standard HuggingFace pipelines are supported - find out more details in the [documentation](https://www.lepton.ai/docs/advanced/prebuilt_photons#hugging-face-photons). Not all HuggingFace models are supported though, as many of them contain custom code and are not standard pipelines. If you find a popular model you would like to support, please [open an issue or a PR](https://github.com/leptonai/leptonai/issues/new).
## Checking out more examples
You can find out more examples from the [examples repository](https://github.com/leptonai/examples). For example, launch the Stable Diffusion XL model with:
```shell
git clone [email protected]:leptonai/examples.git
cd examples
``````python
lep photon runlocal -n sdxl -m advanced/sdxl/sdxl.py
```Once the service is running, you can access it with:
```python
from leptonai.client import Client, localc = Client(local(port=8080))
img_content = c.run(prompt="a cat launching rocket", seed=1234)
with open("cat.png", "wb") as fid:
fid.write(img_content)
```or access the mounted Gradio UI at [http://localhost:8080/ui](http://localhost:8080/ui). Check the [README file](https://github.com/leptonai/examples/blob/main/advanced/sdxl/README.md) for more details.
A fully managed SDXL is hosted at [https://dashboard.lepton.ai/playground/sdxl](https://dashboard.lepton.ai/playground/sdxl) with API access.
## Writing your own photons
Writing your own photon is simple: write a Python Photon class and decorate functions with `@Photon.handler`. As long as your input and output are JSON serializable, you are good to go. For example, the following code launches a simple echo service:
```python
# my_photon.py
from leptonai.photon import Photonclass Echo(Photon):
@Photon.handler
def echo(self, inputs: str) -> str:
"""
A simple example to return the original input.
"""
return inputs
```You can then launch the service with:
```shell
lep photon runlocal -n echo -m my_photon.py
```Then, you can use your service as follows:
```python
from leptonai.client import Client, localc = Client(local(port=8080))
# will print available paths
print(c.paths())
# will print the doc for c.echo. You can also use `c.echo?` in Jupyter.
print(c.echo.__doc__)
# will actually call echo.
c.echo(inputs="hello world")
```For more details, checkout the [documentation](https://lepton.ai/docs/) and the [examples](https://github.com/leptonai/examples).
## Contributing
Contributions and collaborations are welcome and highly appreciated. Please check out the [contributor guide](https://github.com/leptonai/leptonai/blob/main/CONTRIBUTING.md) for how to get involved.
## License
The Lepton AI Python library is released under the Apache 2.0 license.
Developer Note: early development of LeptonAI was in a separate mono-repo, which is why you may see commits from the `leptonai/lepton` repo. We intend to use this open source repo as the source of truth going forward.