zgiai/ZGI.AI

ZGI

An Agent Runtime workspace with source code available for building, running, and operating AI agents, workflows, skills, knowledge, and model routes.

_{Why ZGI · Platform · Quick Start · Development · Docs · Contributing · License}

Why ZGI

ZGI is an Agent Runtime platform with source code available for teams that need AI apps to do real work, not just answer in a chat box. It combines agent applications, visual workflow orchestration, model routing, workspace knowledge, database access, memory, reusable skills, and sandboxed tool execution in one self-hostable workspace.

Use it to build internal AI tools, publish agent experiences, bind agents to approved knowledge, databases, and workflows, run skill-powered tasks such as file generation, charts, reports, scheduling, and calculations, and keep runtime control close to your own systems.

Platform

Area	What you can build
Agent apps	Publish assistants with instructions, model settings, memory, knowledge, file upload, and skills.
Workflow automation	Build multi-step processes with LLM calls, branches, loops, approvals, code execution, notifications, and retrieval.
Runtime skills	Give agents reusable capabilities for files, charts, reports, scheduling, calculations, databases, and workflow calls.
Knowledge and data	Bind agents to approved knowledge bases and database tables instead of exposing broad workspace access.
Model routing	Manage providers, model defaults, credentials, policies, and pricing metadata in one place.
Self-hosted runtime	Run the console, API, sandbox, runner, PostgreSQL, and Redis locally or in your own infrastructure.

Quick Start

Start the full local stack:

make dev-docker

If you do not have make, run the startup script directly:

./dev/start-docker

Open the console:

http://localhost:2679

On first launch, create the first administrator account. ZGI does not ship with a default admin account.

Stop the stack:

make docker-down

View logs:

make docker-logs

Development

For source development, install:

• Docker and Docker Compose
• Make
• Go
• Node.js and pnpm

The web app uses pnpm@10.12.1.

Prepare dependencies:

make setup

Run the API and web app from source in separate terminals:

make dev-docker
make dev-api
make dev-web

Documentation

Read the product documentation at docs.zgi.ai.

Repository-local README files are kept for development and contribution notes.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

Community expectations are documented in CODE_OF_CONDUCT.md.

For security-sensitive reports, follow SECURITY.md.

License

ZGI source code is available under the ZGI Community License, based on Apache License 2.0 with additional conditions. ZGI is free for personal, research, educational, and internal organizational use. Hosted multi-tenant services, white-label distribution, and removal of official ZGI branding require a commercial license. This license is not an OSI-approved open source license. See LICENSE for details.

The Apache License 2.0 text referenced by the ZGI Community License is included in LICENSE-APACHE.