chore: Update README.md
Update Jan README
This commit is contained in:
parent
570f6b330c
commit
41f7323b20
125
README.md
125
README.md
@ -1,4 +1,4 @@
|
|||||||
# Jan - Turn your computer into an AI computer
|
# Jan - Local AI Assistant
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
@ -12,18 +12,22 @@
|
|||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<a href="https://jan.ai/guides">Getting Started</a>
|
<a href="https://jan.ai/docs/quickstart">Getting Started</a>
|
||||||
- <a href="https://jan.ai/docs">Docs</a>
|
- <a href="https://jan.ai/docs">Docs</a>
|
||||||
- <a href="https://github.com/janhq/jan/releases">Changelog</a>
|
- <a href="https://github.com/janhq/jan/releases">Changelog</a>
|
||||||
- <a href="https://github.com/janhq/jan/issues">Bug reports</a>
|
- <a href="https://github.com/janhq/jan/issues">Bug reports</a>
|
||||||
- <a href="https://discord.gg/AsJ8krTT3N">Discord</a>
|
- <a href="https://discord.gg/AsJ8krTT3N">Discord</a>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
> [!Warning] >**Jan is currently in Development**: Expect breaking changes and bugs!
|
<p align="center">
|
||||||
|
⚠️ <b> Jan is currently in Development</b>: Expect breaking changes and bugs!
|
||||||
|
</p>
|
||||||
|
|
||||||
Jan is an open-source ChatGPT alternative that runs 100% offline on your computer.
|
|
||||||
|
|
||||||
**Jan runs on any hardware.** From PCs to multi-GPU clusters, Jan supports universal architectures:
|
Jan is a ChatGPT-alternative that runs 100% offline on your device. Our goal is to make it easy for a layperson to download and run LLMs and use AI with **full control** and **privacy**.
|
||||||
|
|
||||||
|
Jan is powered by [Cortex](https://github.com/janhq/cortex.cpp), our embeddable local AI engine that runs on any hardware.
|
||||||
|
From PCs to multi-GPU clusters, Jan & Cortex supports universal architectures:
|
||||||
|
|
||||||
- [x] NVIDIA GPUs (fast)
|
- [x] NVIDIA GPUs (fast)
|
||||||
- [x] Apple M-series (fast)
|
- [x] Apple M-series (fast)
|
||||||
@ -31,6 +35,12 @@ Jan is an open-source ChatGPT alternative that runs 100% offline on your compute
|
|||||||
- [x] Linux Debian
|
- [x] Linux Debian
|
||||||
- [x] Windows x64
|
- [x] Windows x64
|
||||||
|
|
||||||
|
#### Features:
|
||||||
|
- [Model Library](https://jan.ai/docs/models/manage-models#add-models) with popular LLMs like Llama, Gemma, Mistral, or Qwen
|
||||||
|
- Connect to [Remote AI APIs](https://jan.ai/docs/remote-models/openai) like Groq and OpenRouter
|
||||||
|
- Local API Server with OpenAI-equivalent API
|
||||||
|
- [Extensions](https://jan.ai/docs/extensions) for customizing Jan
|
||||||
|
|
||||||
## Download
|
## Download
|
||||||
|
|
||||||
<table>
|
<table>
|
||||||
@ -141,79 +151,70 @@ Jan is an open-source ChatGPT alternative that runs 100% offline on your compute
|
|||||||
</tr>
|
</tr>
|
||||||
</table>
|
</table>
|
||||||
|
|
||||||
Download the latest version of Jan at https://jan.ai/ or visit the **[GitHub Releases](https://github.com/janhq/jan/releases)** to download any previous release.
|
Download the latest version of Jan at https://jan.ai/ or visit the [GitHub Releases](https://github.com/janhq/jan/releases) to download any previous release.
|
||||||
|
|
||||||
## Demo
|
## Demo
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
_Realtime Video: Jan v0.4.3-nightly on a Mac M1, 16GB Sonoma 14_
|
|
||||||
|
|
||||||
|
https://github.com/user-attachments/assets/c3592fa2-c504-4d9d-a885-7e00122a50f3
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
*Realtime Video: Jan v0.5.7 on a Mac M2, 16GB Sonoma 14.2*
|
||||||
|
|
||||||
## Quicklinks
|
## Quicklinks
|
||||||
|
|
||||||
#### Jan
|
### Jan
|
||||||
|
|
||||||
- [Jan website](https://jan.ai/)
|
- [Jan Website](https://jan.ai/)
|
||||||
- [Jan GitHub](https://github.com/janhq/jan)
|
- [Jan GitHub](https://github.com/janhq/jan)
|
||||||
- [User Guides](https://jan.ai/guides/)
|
- [Documentation](https://jan.ai/docs)
|
||||||
- [Developer docs](https://jan.ai/developer/)
|
- [Jan Changelog](https://jan.ai/changelog)
|
||||||
- [API reference](https://jan.ai/api-reference/)
|
- [Jan Blog](https://jan.ai/blog)
|
||||||
- [Specs](https://jan.ai/docs/)
|
|
||||||
|
|
||||||
#### Nitro
|
### Cortex.cpp
|
||||||
|
Jan is powered by **Cortex.cpp**. It is a C++ command-line interface (CLI) designed as an alternative to [Ollama](https://ollama.com/). By default, it runs on the llama.cpp engine but also supports other engines, including ONNX and TensorRT-LLM, making it a multi-engine platform.
|
||||||
|
|
||||||
Nitro is a high-efficiency C++ inference engine for edge computing. It is lightweight and embeddable, and can be used on its own within your own projects.
|
|
||||||
|
|
||||||
- [Nitro Website](https://nitro.jan.ai)
|
|
||||||
- [Nitro GitHub](https://github.com/janhq/nitro)
|
|
||||||
- [Documentation](https://nitro.jan.ai/docs)
|
|
||||||
- [API Reference](https://nitro.jan.ai/api-reference)
|
|
||||||
|
|
||||||
## Troubleshooting
|
|
||||||
|
|
||||||
As Jan is in development mode, you might get stuck on a broken build.
|
|
||||||
|
|
||||||
To reset your installation:
|
|
||||||
|
|
||||||
1. Use the following commands to remove any dangling backend processes:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
ps aux | grep nitro
|
|
||||||
```
|
|
||||||
|
|
||||||
Look for processes like "nitro" and "nitro_arm_64," and kill them one by one with:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
kill -9 <PID>
|
|
||||||
```
|
|
||||||
|
|
||||||
2. **Remove Jan from your Applications folder and Cache folder**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
make clean
|
|
||||||
```
|
|
||||||
|
|
||||||
This will remove all build artifacts and cached files:
|
|
||||||
|
|
||||||
- Delete Jan extension from your `~/jan/extensions` folder
|
|
||||||
- Delete all `node_modules` in current folder
|
|
||||||
- Clear Application cache in `~/Library/Caches/jan`
|
|
||||||
|
|
||||||
|
- [Cortex Website](https://cortex.so/)
|
||||||
|
- [Cortex GitHub](https://github.com/janhq/cortex.cpp)
|
||||||
|
- [Documentation](https://cortex.so/docs/)
|
||||||
|
- [Models Library](https://cortex.so/models)
|
||||||
|
- API Reference: *Under development*
|
||||||
|
|
||||||
## Requirements for running Jan
|
## Requirements for running Jan
|
||||||
|
|
||||||
- MacOS: 13 or higher
|
- **MacOS**: 13 or higher
|
||||||
- Windows:
|
- **Windows**:
|
||||||
- Windows 10 or higher
|
- Windows 10 or higher
|
||||||
- To enable GPU support:
|
- To enable GPU support:
|
||||||
- Nvidia GPU with CUDA Toolkit 11.7 or higher
|
- Nvidia GPU with CUDA Toolkit 11.7 or higher
|
||||||
- Nvidia driver 470.63.01 or higher
|
- Nvidia driver 470.63.01 or higher
|
||||||
- Linux:
|
- **Linux**:
|
||||||
- glibc 2.27 or higher (check with `ldd --version`)
|
- glibc 2.27 or higher (check with `ldd --version`)
|
||||||
- gcc 11, g++ 11, cpp 11 or higher, refer to this [link](https://jan.ai/guides/troubleshooting/gpu-not-used/#specific-requirements-for-linux) for more information
|
- gcc 11, g++ 11, cpp 11 or higher, refer to this [link](https://jan.ai/guides/troubleshooting/gpu-not-used/#specific-requirements-for-linux) for more information
|
||||||
- To enable GPU support:
|
- To enable GPU support:
|
||||||
- Nvidia GPU with CUDA Toolkit 11.7 or higher
|
- Nvidia GPU with CUDA Toolkit 11.7 or higher
|
||||||
- Nvidia driver 470.63.01 or higher
|
- Nvidia driver 470.63.01 or higher
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
As Jan is in development mode, you might get stuck on a some common issues:
|
||||||
|
- [Troubleshooting a broken build](https://jan.ai/docs/troubleshooting#broken-build)
|
||||||
|
- [Troubleshooting NVIDIA GPU](https://jan.ai/docs/troubleshooting#troubleshooting-nvidia-gpu)
|
||||||
|
- [Troubleshooting Something's Amiss](https://jan.ai/docs/troubleshooting#somethings-amiss)
|
||||||
|
|
||||||
|
|
||||||
|
If you can't find what you need in our troubleshooting guide, feel free reach out to us for extra help:
|
||||||
|
1. Copy your [error logs & device specifications](https://jan.ai/docs/troubleshooting#how-to-get-error-logs).
|
||||||
|
2. Go to our [Discord](https://discord.com/invite/FTk2MvZwJH) & send it to **#🆘|get-help** channel for further support.
|
||||||
|
|
||||||
|
*Check the logs to ensure the information is what you intend to send. Note that we retain your logs for only 24 hours, so report any issues promptly.*
|
||||||
|
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
Contributions are welcome! Please read the [CONTRIBUTING.md](CONTRIBUTING.md) file
|
Contributions are welcome! Please read the [CONTRIBUTING.md](CONTRIBUTING.md) file
|
||||||
@ -242,11 +243,7 @@ Contributions are welcome! Please read the [CONTRIBUTING.md](CONTRIBUTING.md) fi
|
|||||||
|
|
||||||
This will start the development server and open the desktop app.
|
This will start the development server and open the desktop app.
|
||||||
|
|
||||||
3. (Optional) **Run the API server without frontend**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
yarn dev:server
|
|
||||||
```
|
|
||||||
|
|
||||||
### For production build
|
### For production build
|
||||||
|
|
||||||
@ -271,18 +268,18 @@ Jan builds on top of other open-source projects:
|
|||||||
|
|
||||||
- Bugs & requests: file a GitHub ticket
|
- Bugs & requests: file a GitHub ticket
|
||||||
- For discussion: join our Discord [here](https://discord.gg/FTk2MvZwJH)
|
- For discussion: join our Discord [here](https://discord.gg/FTk2MvZwJH)
|
||||||
- For business inquiries: email hello@jan.ai
|
- For business inquiries: email hello@jan.ai
|
||||||
- For jobs: please email hr@jan.ai
|
- For jobs: please email hr@jan.ai
|
||||||
|
|
||||||
## Trust & Safety
|
## Trust & Safety
|
||||||
|
|
||||||
Beware of scams.
|
Beware of scams!
|
||||||
|
|
||||||
- We will never ask you for personal info
|
- We will never request your personal information.
|
||||||
- We are a free product; there's no paid version
|
- Our product is completely free; no paid version exists.
|
||||||
- We don't have a token or ICO
|
- We do not have a token or ICO.
|
||||||
- We are not actively fundraising or seeking donations
|
- We are a [bootstrapped company](https://en.wikipedia.org/wiki/Bootstrapping), and don't have any external investors (*yet*). We're open to exploring opportunities with strategic partners want to tackle [our mission](https://jan.ai/about#mission) together.
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
Jan is free and open source, under the AGPLv3 license.
|
Jan is free and open source, under the **AGPLv3** license.
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user