mirror of
https://github.com/enricoros/big-AGI.git
synced 2026-05-11 14:10:15 -07:00
Enrico Ros
120 lines
4.3 KiB
Markdown
120 lines
4.3 KiB
Markdown
# Installation Guide
|
|
|
|
Welcome to the big-AGI Installation Guide - Whether you're a developer
|
|
eager to explore, a system integrator, or an enterprise looking for a
|
|
white-label solution, this comprehensive guide ensures a smooth setup
|
|
process for your own instance of big-AGI and related products.
|
|
|
|
**Try big-AGI** - You don't need to install anything if you want to play with big-AGI
|
|
and have your API keys to various model services. You can access our free instance on [big-AGI.com](https://big-agi.com).
|
|
The free instance runs the latest `main-stable` branch from this repository.
|
|
|
|
## 🧩 Build-your-own
|
|
|
|
If you want to change the code, have a deeper configuration,
|
|
add your own models, or run your own instance, follow the steps below.
|
|
|
|
### Local Development
|
|
|
|
**Prerequisites:**
|
|
|
|
- Node.js and npm installed on your machine.
|
|
|
|
**Steps:**
|
|
|
|
1. Clone the big-AGI repository:
|
|
```bash
|
|
git clone https://github.com/enricoros/big-AGI.git
|
|
cd big-AGI
|
|
```
|
|
2. Install dependencies:
|
|
```bash
|
|
npm install
|
|
```
|
|
3. Run the development server:
|
|
```bash
|
|
npm run dev
|
|
```
|
|
Your big-AGI instance is now running at `http://localhost:3000`.
|
|
|
|
### Local Production build
|
|
|
|
The production build is optimized for performance and follows
|
|
the same steps 1 and 2 as for [local development](#local-development).
|
|
|
|
3. Build the production version:
|
|
```bash
|
|
# .. repeat the steps above up to `npm install`, then:
|
|
npm run build
|
|
```
|
|
4. Start the production server (`npx` may be optional):
|
|
```bash
|
|
npx next start --port 3000
|
|
```
|
|
Your big-AGI production instance is on `http://localhost:3000`.
|
|
|
|
### Advanced Customization
|
|
|
|
Want to pre-enable models, customize the interface, or deploy with username/password or alter code to your needs?
|
|
Check out the [Customizations Guide](README.md) for detailed instructions.
|
|
|
|
## ☁️ Cloud Deployment Options
|
|
|
|
To deploy big-AGI on a public server, you have several options. Choose the one that best fits your needs.
|
|
|
|
### Deploy on Vercel
|
|
|
|
Install big-AGI on Vercel with just a few clicks.
|
|
|
|
Create your GitHub fork, create a Vercel project over that fork, and deploy it. Or press the button below for convenience.
|
|
|
|
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fenricoros%2Fbig-AGI&env=OPENAI_API_KEY&envDescription=Backend%20API%20keys%2C%20optional%20and%20may%20be%20overridden%20by%20the%20UI.&envLink=https%3A%2F%2Fgithub.com%2Fenricoros%2Fbig-AGI%2Fblob%2Fmain%2Fdocs%2Fenvironment-variables.md&project-name=big-AGI)
|
|
|
|
### Deploy on Cloudflare
|
|
|
|
Deploy on Cloudflare's global network by installing big-AGI on
|
|
Cloudflare Pages. Check out the [Cloudflare Installation Guide](deploy-cloudflare.md)
|
|
for step-by-step instructions.
|
|
|
|
### Docker Deployments
|
|
|
|
Containerize your big-AGI installation using Docker for portability and scalability.
|
|
Our [Docker Deployment Guide](deploy-docker.md) will walk you through the process,
|
|
or follow the steps below for a quick start.
|
|
|
|
1. (optional) Build the Docker image - if you do not want to use the [pre-built Docker images](https://github.com/enricoros/big-AGI/pkgs/container/big-agi):
|
|
```bash
|
|
docker build -t big-agi .
|
|
```
|
|
2. Run the Docker container with either:
|
|
```bash
|
|
# 2A. if you built the image yourself:
|
|
docker run -d -p 3000:3000 big-agi
|
|
|
|
# 2B. or use the pre-built image:
|
|
docker run -d -p 3000:3000 ghcr.io/enricoros/big-agi
|
|
|
|
# 2C. or use docker-compose:
|
|
docker-compose up
|
|
```
|
|
Access your big-AGI instance at `http://localhost:3000`.
|
|
|
|
### Midori AI Subsystem for Docker Deployment
|
|
|
|
Follow the instructions found on [Midori AI Subsystem Site](https://io.midori-ai.xyz/subsystem/manager/)
|
|
for your host OS. After completing the setup process, install the Big-AGI docker backend to the Midori AI Subsystem.
|
|
|
|
## Enterprise-Grade Installation
|
|
|
|
For businesses seeking a fully-managed, scalable solution, consider our managed installations.
|
|
Enjoy all the features of big-AGI without the hassle of infrastructure management. [hello@big-agi.com](mailto:hello@big-agi.com) to learn more.
|
|
|
|
## Support
|
|
|
|
Join our vibrant community of developers, researchers, and AI enthusiasts. Share your projects, get help, and collaborate with others.
|
|
|
|
- [Discord Community](https://discord.gg/MkH4qj2Jp9)
|
|
- [Twitter](https://twitter.com/yourusername)
|
|
|
|
For any questions or inquiries, please don't hesitate to [reach out to our team](mailto:hello@big-agi.com).
|