Skip to content

Latest commit

 

History

History
130 lines (84 loc) · 3.14 KB

README.md

File metadata and controls

130 lines (84 loc) · 3.14 KB
Raw

Multi-Agent Operating System Core (maos-core)

Introduction

MAOS (Multi-Agent Operating System) is an innovative project designed to provide robust infrastructure for AI agents. It focuses on:

  1. Managing shared infrastructure and resources
  2. Regulating agent execution models

The core component of MAOS serves as the foundation for building complex multi-agent systems.

Features

  • Resource allocation and management
  • Agent execution regulation
  • Scalable infrastructure for AI agents
  • [more key features as they are developed]

Getting Started

Prerequisites

Go 1.22 or later is required

Installation

Kubernates Bootstraping

After the maos-core service is up and running, you need to create an agent and token for the Admin UI:

  1. Set up Kubernetes port forwarding:
kubectl -n devbxpay port-forward service/devbxpay-portals-maos-core 5001:5000
  1. Create an agent via the API:
curl -X POST --location 'http://127.0.0.1:5001/v1/admin/agents' \
  -H 'Authorization: Bearer bootstrap-token' \
  -H 'Content-Type: application/json' \
  --data '{"name": "admin-portal"}'

Note: Save the id from the response for use in step 3.

  1. Create a token for the Admin UI:
curl -X POST --location 'http://127.0.0.1:5001/v1/admin/api_tokens' \
  -H 'Authorization: Bearer bootstrap-token' \
  -H 'Content-Type: application/json' \
  --data '{"agent_id": <id_from_step_2>, "expire_at":2037780304, "created_by":"kevin@bluextrade.com", "permissions":["admin"]}'

Note: Replace <id_from_step_2> with the actual agent ID returned in step 2.

  1. Configure the Admin UI: After the token is created, the bootstrap token will become invalid. Assign the newly created token to the Admin UI configuration.

Create invocation manaully

make sure you have a token with create:invocation permission:

curl -v -X POST --location 'http://127.0.0.1:5001/v1/invocations/sync' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  --data '{"agent":"<agent-name>","meta":{"kind": "<method name>"},"payload":{.....}}'

Development

Setting Up the Development Environment

Install dependencies:

go mod download

Running Tests

To execute tests, follow these steps:

  1. Create testing databases:
createdb maos-test

This command creates a testing databases under system account

  1. Set up the database connection:

If you created the test database with default settings, you can skip this step.

If you used a specific username or different database name, you need to set the TEST_DATABASE_URL environment variable: Option A: Set it directly in your shell:

export TEST_DATABASE_URL=postgres://username:password@localhost/maos-test?sslmode=disable

Option B: Add it to a .env file in the project root:

TEST_DATABASE_URL=postgres://username:password@localhost/maos-test?sslmode=disable

Replace username, password, and maos-test with your specific database credentials and name.

  1. Run the tests using the following methods:
go test ./...

To run tests without using the cache:

go test -count=1 ./...

For verbose output:

go test -v ./...