Skip to content
asterai-ioPublic

About

The asterai CLI and runtime for running WASM components bundled in environments.

Topics

Resources

Contributing

Stars

22 stars

Watchers

1 watching

Forks

Repository files navigation


Asterai Logo

Asterai

The AI Agent Tool Marketplace.
Discover and deploy tools for your AI agents, written in any language.

License Discord GitHub stars X Follow


✨ Overview

Asterai is an open-source platform and runtime for creating, sharing, and executing portable, sandboxed WebAssembly (WASI) components. Built around wasmtime, it provides a neutral compute substrate for the agentic era.

  • Language Interoperability: Write tools in any language (Rust, Go, Python, JS, C/C++) — components written in different languages work together seamlessly via type-safe WIT interfaces
  • Sandboxed Execution: AI agents can run untrusted code safely with WASI security guarantees
  • True Portability: Deploy anywhere (local, cloud, edge) with no dependency hell — same behavior everywhere
  • Instant Deployment: Tools just work without DevOps or container configuration

🚀 Installation

npm (recommended):

npm install -g @asterai/cli

Cargo (Rust users):

cargo install asterai

Binary releases: Download from GitHub Releases

📦 Structure

Directory Description
cli The asterai CLI utility
runtime The asterai runtime library
component-examples Example components

🔧 CLI Command Reference

The CLI operates in two modes: local (offline, working with files in ~/.local/bin/asterai/artifacts) and remote (online, interacting with the Asterai registry API).

By default, most commands operate locally. To operate on the remote registry instead, pass the --remote or -r flag. This enables a git-like workflow where you modify locally and sync when ready.

Command Local Remote --remote Notes
Auth
auth login ✓ Stores API key to local file
auth logout ✓ Removes local API key file
auth status ✓ ✓ Checks local file, validates against API
Environment
env init ✓ Creates local environment
env inspect ✓ Reads environment config
env add-component ✓ Adds component to environment
env remove-component ✓ Removes component from environment
env set-var ✓ Sets environment variable
env list ✓ ✓ Shows local and remote environments
env run ✓ ✓ Checks local first, pulls if not found
env pull ✓ Fetches from registry to local
env push ✓ ✓ Pushes local to registry
env delete ✓ ✓ ✓ Deletes environment (-r for registry)
Component
component init ✓ Creates local component project
component list ✓ Lists local components
component pkg ✓ Packages WIT locally
component pull ✓ Fetches from registry to local
component push ✓ ✓ Pushes local to registry
component delete ✓ Deletes local component

Legend:

  • Local: Command reads/writes local files
  • Remote: Command interacts with the Asterai API
  • --remote: Pass -r or --remote to operate on the registry instead of locally

📚 Documentation

The asterai documentation is available at docs.asterai.io

About

The asterai CLI and runtime for running WASM components bundled in environments.

Topics

Resources

Contributing

Stars

22 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages