ai

Build LLM Apps Easily

English | 中文 | 日本語 | 한국어

Drag & drop UI to build your customized LLM flow

⚡Quick Start

Download and Install NodeJS >= 18.15.0

1. Install Hanzo

   npm install -g @hanzo/ai

2. Start Hanzo

   npx @hanzo/ai start

   With username & password

   npx hanzo start --HANZO_USERNAME=user --HANZO_PASSWORD=1234

3. Open http://localhost:3000

🐳 Docker

Docker Compose

1. Go to docker folder at the root of the project
2. Copy .env.example file, paste it into the same location, and rename to .env
3. docker compose up -d
4. Open http://localhost:3000
5. You can bring the containers down by docker compose stop

Docker Image

1. Build the image locally:

   docker build --no-cache -t hanzo .

2. Run image:

   docker run -d --name hanzo -p 3000:3000 hanzo

3. Stop image:

   docker stop hanzo

👨‍💻 Developers

Hanzo AI has 3 different modules in a single mono repository.

• server: Node backend to serve API logics
• ui: React frontend
• components: Third-party nodes integrations

Prerequisite

• Install PNPM

  npm i -g pnpm

Setup

1. Clone the repository

   git clone https://github.com/hanzoai/ai.git

2. Go into repository folder

   cd ai

3. Install all dependencies of all modules:

   pnpm install

4. Build all the code:

   pnpm build

5. Start the app:

   pnpm start

   You can now access the app on http://localhost:3000

6. For development build:

   • Create .env file and specify the VITE_PORT (refer to .env.example) in packages/ui

   • Create .env file and specify the PORT (refer to .env.example) in packages/server

   • Run

     pnpm dev

   Any code changes will reload the app automatically on http://localhost:8080

🔒 Authentication

To enable app level authentication, add HANZO_USERNAME and HANZO_PASSWORD to the .env file in packages/server:

HANZO_USERNAME=user
HANZO_PASSWORD=1234

🌱 Env Variables

Hanzo support different environment variables to configure your instance. You can specify the following variables in the .env file inside packages/server folder. Read more

📖 Documentation

Hanzo Docs

🌐 Self Host

Deploy Hanzo AI self-hosted in your existing infrastructure, we support various deployments

• AWS

• Azure

• Digital Ocean

• GCP

• Others

  • Railway

    

  • Render

    

  • HuggingFace Spaces

    

  • Elestio

    

  • Sealos

    

  • RepoCloud

    

💻 Cloud Hosted

For a robust and scalable cloud hosted version, use Hanzo AI.

🙋 Support

Feel free to ask any questions, raise problems, and request new features in discussion

🙌 Contributing

Thanks go to these awesome contributors

See contributing guide. Reach out to us via Email if you have any questions or issues.

📄 License

Source code in this repository is made available under the Apache License Version 2.0.