PILSO OS (Pilot Interface for LLM Signature Operations) is a secure operating system for agents — letting LLMs sign and execute blockchain transactions via modular, trustless MCP servers.

Built for Web3 automation. Private keys stay in your wallet.

Built on a modular suite of MCP servers, PILSO connects agents to blockchains through your own wallet (like MetaMask), turning natural language into trustless execution flows.

🔐 Secure by design
🧩 Modular by architecture
🧠 Built for agents

• 🪙 Check token balances & transfer ERC-20s
• 📝 Compile and deploy smart contracts
• 🔍 Resolve chain metadata dynamically
• ✍️ Sign transactions via MetaMask — non-custodial
• 🤖 Power custom LLM agents with scoped, secure roles

User ↔ LLM Agent ↔ MCP Tools ↔ Wallet ↔ Blockchain

• Agents process user prompts and decide which tools to use
• MCP servers prepare unsigned payloads (no private keys involved)
• The wallet signs — you stay in control

Requires Node.js 18+

# Run the PILSO CLI
npx pilso

# Start an agent session using a defined role
npx pilso start -r signer

Create your configs in the root of your project:

pilso.config.json    # LLM, tool endpoints, logging
pilso-roles.json     # Agent roles, tools, and guardrails

/cli/               # CLI entrypoint (npx pilso)
/mcp/               # All official MCP servers (modular tools)
/docs/              # (Optional) GitBook or Markdown docs
pilso.config.json   # Global agent + tool configuration
pilso-roles.json    # Agent role definitions

Contribuions welcome:

• New MCP servers (bridging, verification, AI audit, etc.)
• Wallet integrations (WalletConnect, Gnosis Safe)
• Hosted agents + dashboard interfaces
• CLI improvements and advanced role logic

Open a pull request or start a discussion anytime.

Full documentation overview: https://docs.pil.so

MIT License