Skip to main content

about

What is ZkAGI OS?

ZkAGI OS is an all-batteries-included, modular, and upgradeable AI x Crypto Operating System (open-source) built to fuel a new class of Secret Sentients / AI Secret Agents and AI Super Agents. It is an end-to-end customizable OS usable by normies and advanced developers alike, allowing community-centred innovation and incentives.

An image generated on ZkTerminal

An image generated on ZkTerminal (type /image-gen < your prompt> for the same)

Why does the AI agent landscape need ZkAGI OS?

Most existing AI agents are limited to feature sets provided by big-tech AI APIs, restricting innovation and customizability. ZkAGI OS enables Super Agents that run powerful open-source AI models and Secret Agents that preserve on-chain and training-data privacy.

  • Social agents (Bully, Zerebro, Luna Virtuals, etc.) were the first popular class, but are constrained by closed-source APIs
  • Super Agents run AI models not offered by big tech but openly available on GitHub
  • Secret Agents preserve privacy on training data and on-chain activity -- being untraceable on-chain is an agent secret power
  • Privacy AI delivers the same outcomes as public AI without compromising sensitive information
  • The OS serves as a strong foundation built on years of R&D, upgradeable and modifiable by anyone with requisite skills

What are the spaces in ZkAGI OS?

Similar to traditional operating systems that have a user space and a kernel space, ZkAGI OS is organized into four distinct spaces: Economic Space, Compute Node Space, Model Hosting Space, and Agent System Space. Each space handles a different layer of the decentralized AI stack.

Economic Space

Economic space

On Blockchain Networks like Solana or Base

Compute Node Space

compute node space

CPU & GPU & TEE nodes are clustered, AI models are run on the cluster which handles resource management of these nodes according to workload and privacy requirements

Model Hosting Space

compute node space

Models are sharded and stored across distributed nodes, resource manager within the Model hosting space picks the best nodes to process workload and return an output. Requests to the model hosting space are initiated through the Zynapse API


What is the Zynapse API?

The Zynapse API is the gateway that routes workloads across the ZkAGI network, comprising a subnet selector, a model selector, and a zk-messenger. These selectors decide how a workload should be processed based on the request initiator and dataset requirements.

zynapse api

Zynapse API comprises of a subnet selector, a model selector and zk-messenger. The selectors work together in deciding how the workload requested by a human user or agent should be processed based on the initiator of request and data set (whether it requires confidential computing in a private cluster or regular public cluster/what kind of wallets)

  • Subnet selector -- determines whether to route to a public or private cluster
  • Model selector -- picks the appropriate AI model for the workload
  • zk-messenger -- handles zero-knowledge verification and privacy messaging

What is the Agent System Space / User Space?

The Agent System Space (User Space) hosts the programs that dictate agent functioning, such as frameworks like Eliza bound with the Zynapse API. It controls agent memory systems, actions, evaluators, character files, and providers, while apps like ZkTerminal build on the Zynapse API with their own UI and memory systems.

user space

Programs that dictate the functioning of an agent like program running Eliza Framework bound with Zynapse API controls agent memory system, actions, evaluators, character files and providers, similarly apps like ZkTerminal can build with Zynapse API and have their own UI & Memory system. The rules around communicating with other apps & agents in the network are assigned in the program code hosted in the Agent System Space/User Space

  • Agent frameworks (e.g., Eliza) bind with Zynapse API to control memory, actions, evaluators, character files, and providers
  • Apps like ZkTerminal use Zynapse API with their own UI and memory system
  • Communication rules between apps and agents are assigned in program code hosted in this space

Disclaimer

This document explains ZkAGI OS concepts in simple terms with visual aids, avoiding jargon as much as possible. The basic building blocks of ZkAGI OS have been shipped, with more items being packaged and released over time.