π‘ Get help - βFAQ πDiscussions π¬ Discord π Documentation website
π» Quickstart π£ News π« Examples πΌοΈ Models π Roadmap
LocalAI is the free, Open Source OpenAI alternative. LocalAI act as a drop-in replacement REST API thatβs compatible with OpenAI (Elevenlabs, Anthropic... ) API specifications for local AI inferencing. It allows you to run LLMs, generate images, audio (and not only) locally or on-prem with consumer grade hardware, supporting multiple model families. Does not require GPU. It is created and maintained by Ettore Di Giacinto.
- Chat, TTS, and Image generation in the WebUI: mudler#2222
 - Reranker API: mudler#2121
 - Gallery WebUI: mudler#2104
 - llama3: mudler#2076
 - Parler-TTS: mudler#2027
 - Openvino support: mudler#1892
 - Vector store: mudler#1795
 - All-in-one container image: mudler#1855
 
Hot topics (looking for contributors):
- WebUI improvements: mudler#2156
 - Backends v2: mudler#1126
 - Improving UX v2: mudler#1373
 - Assistant API: mudler#1273
 - Moderation endpoint: mudler#999
 - Vulkan: mudler#1647
 
If you want to help and contribute, issues up for grabs: https://github.com/mudler/LocalAI/issues?q=is%3Aissue+is%3Aopen+label%3A%22up+for+grabs%22
π» Getting started
For a detailed step-by-step introduction, refer to the Getting Started guide.
For those in a hurry, here's a straightforward one-liner to launch a LocalAI AIO(All-in-one) Image using docker:
docker run -ti --name local-ai -p 8080:8080 localai/localai:latest-aio-cpu
# or, if you have an Nvidia GPU:
# docker run -ti --name local-ai -p 8080:8080 --gpus all localai/localai:latest-aio-gpu-nvidia-cuda-12π Features
- π Text generation with GPTs (
llama.cpp,gpt4all.cpp, ... π and more) - π£ Text to Audio
 - π Audio to Text (Audio transcription with 
whisper.cpp) - π¨ Image generation with stable diffusion
 - π₯ OpenAI functions π
 - π§ Embeddings generation for vector databases
 - βοΈ Constrained grammars
 - πΌοΈ Download Models directly from Huggingface
 - π₯½ Vision API
 - π Reranker API
 
Check out the Getting started section in our documentation.
Build and deploy custom containers:
WebUIs:
Model galleries
Other:
- Helm chart https://github.com/go-skynet/helm-charts
 - VSCode extension https://github.com/badgooooor/localai-vscode-plugin
 - Terminal utility https://github.com/djcopley/ShellOracle
 - Local Smart assistant https://github.com/mudler/LocalAGI
 - Home Assistant https://github.com/sammcj/homeassistant-localai / https://github.com/drndos/hass-openai-custom-conversation
 - Discord bot https://github.com/mudler/LocalAGI/tree/main/examples/discord
 - Slack bot https://github.com/mudler/LocalAGI/tree/main/examples/slack
 - Telegram bot https://github.com/mudler/LocalAI/tree/master/examples/telegram-bot
 - Examples: https://github.com/mudler/LocalAI/tree/master/examples/
 
- π New! LLM finetuning guide
 - How to build locally
 - How to install in Kubernetes
 - Projects integrating LocalAI
 - How tos section (curated by our community)
 
π π₯ Media, Blogs, Social
- Run LocalAI on AWS EKS with Pulumi
 - Run LocalAI on AWS
 - Create a slackbot for teams and OSS projects that answer to documentation
 - LocalAI meets k8sgpt
 - Question Answering on Documents locally with LangChain, LocalAI, Chroma, and GPT4All
 - Tutorial to use k8sgpt with LocalAI
 
If you utilize this repository, data in a downstream project, please consider citing it with:
@misc{localai,
  author = {Ettore Di Giacinto},
  title = {LocalAI: The free, Open source OpenAI alternative},
  year = {2023},
  publisher = {GitHub},
  journal = {GitHub repository},
  howpublished = {\url{https://github.com/go-skynet/LocalAI}},
Do you find LocalAI useful?
Support the project by becoming a backer or sponsor. Your logo will show up here with a link to your website.
A huge thank you to our generous sponsors who support this project:
![]()  | 
|---|
| Spectro Cloud | 
| Spectro Cloud kindly supports LocalAI by providing GPU and computing resources to run tests on lamdalabs! | 
And a huge shout-out to individuals sponsoring the project by donating hardware or backing the project.
- Sponsor list
 - JDAM00 (donating HW for the CI)
 
LocalAI is a community-driven project created by Ettore Di Giacinto.
MIT - Author Ettore Di Giacinto
LocalAI couldn't have been built without the help of great software already available from the community. Thank you!
- llama.cpp
 - https://github.com/tatsu-lab/stanford_alpaca
 - https://github.com/cornelk/llama-go for the initial ideas
 - https://github.com/antimatter15/alpaca.cpp
 - https://github.com/EdVince/Stable-Diffusion-NCNN
 - https://github.com/ggerganov/whisper.cpp
 - https://github.com/saharNooby/rwkv.cpp
 - https://github.com/rhasspy/piper
 
This is a community project, a special thanks to our contributors! π€

