Gaianet Node
Install, run and deploy your own decentralized AI agent service
What is Gaianet Node?
Gaianet Node is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to install, run and deploy your own decentralized ai agent service
Install, run and deploy your own decentralized AI agent service
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Install, run and deploy your own decentralized AI agent serv
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx gaianet-nodeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Gaianet Node
GaiaNet Node lets anyone install, configure, and run a personal decentralized AI agent service using a local LLM inference engine (WasmEdge with GGML) and a Qdrant vector database for RAG, then optionally join the GaiaNet peer-to-peer network to share the node publicly under a custom domain. Each node is fully self-contained — model files, vector snapshots, prompt templates, and port settings are all configurable through a simple CLI — making it the practical choice for developers who want private, on-device AI inference without cloud dependencies or per-token costs.
Prerequisites
- A Linux or macOS machine (Windows via WSL2) with at least 8 GB RAM for most open-weight models
- curl available on the system for the installer script
- WasmEdge runtime 0.13.5+ with the GGML plugin (installed automatically by the GaiaNet installer)
- Qdrant vector database binary (installed automatically by the GaiaNet installer)
- Optional: a GaiaNet account and registered domain if you want to publish the node to the decentralized network
Install the GaiaNet node
Run the official installer script. It downloads the gaianet binary, WasmEdge runtime, the GGML plugin, and Qdrant to $HOME/gaianet by default.
curl -sSfL 'https://github.com/GaiaNet-AI/gaianet-node/releases/latest/download/install.sh' | bashInitialize the node (download model and vector DB)
Running gaianet init downloads the default chat model and embedding model files specified in your config.json, as well as the vector database snapshot. This step can take several minutes depending on model size and connection speed.
gaianet initCustomize the node configuration
Use the gaianet config subcommand to set your preferred model, context size, system prompt, RAG policy, and port. Run gaianet init again after any config change to re-download required files.
gaianet config \
--chat-url https://huggingface.co/.../model.gguf \
--chat-ctx-size 4096 \
--system-prompt "You are a helpful assistant." \
--port 8080
gaianet initStart the node
Launch the GaiaNet node. Use --local-only to restrict access to localhost only, or omit the flag to allow network access for joining the GaiaNet public network.
gaianet start --local-onlyInteract via the web dashboard or API
The node exposes an OpenAI-compatible REST API and a web chat dashboard. You can use any OpenAI-compatible client by pointing it at your node's base URL.
# Web dashboard: http://localhost:8080
# OpenAI-compatible API base: http://localhost:8080/v1Gaianet Node Examples
Client configuration
claude_desktop_config.json snippet for connecting to a locally running GaiaNet node via its MCP-compatible interface.
{
"mcpServers": {
"gaianet-node": {
"command": "npx",
"args": ["gaianet-node"],
"env": {
"GAIANET_API_BASE": "http://localhost:8080/v1"
}
}
}
}Prompts to try
Sample prompts once your GaiaNet node is running with a knowledge base loaded.
- "Search my local knowledge base for documents about data privacy regulations."
- "Answer this question using only information from my uploaded PDFs: [question]"
- "What model is currently running on my GaiaNet node and what context size is it using?"
- "Summarize the key points from the vector database snapshot I loaded."Troubleshooting Gaianet Node
gaianet init fails with a model download error
Check your internet connection and verify the --chat-url points to a valid .gguf file URL. Hugging Face URLs must be direct download links (use the 'Download' button on HF to get the raw URL). Retry with a smaller model if you are bandwidth-constrained.
Node starts but chat returns empty or error responses
Run `gaianet stop` then `gaianet start` and watch the output for WasmEdge or GGML plugin errors. Ensure your machine has enough free RAM for the model (typically 2x the model file size). Reduce --chat-ctx-size if you are hitting memory limits.
RAG search returns no results from uploaded documents
Verify Qdrant is running (it should start automatically with `gaianet start`). Check that the --embedding-url in your config points to a valid embedding model and that gaianet init completed without errors for the embedding model download.
Frequently Asked Questions about Gaianet Node
What is Gaianet Node?
Gaianet Node is a Model Context Protocol (MCP) server that install, run and deploy your own decentralized ai agent service It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Gaianet Node?
Follow the installation instructions on the Gaianet Node GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Gaianet Node?
Gaianet Node works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Gaianet Node free to use?
Yes, Gaianet Node is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.
Gaianet Node Alternatives — Similar Cloud Services Servers
Looking for alternatives to Gaianet Node? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Gaianet Node in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Gaianet Node?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.