Skip to content
/ kuber Public

A MCP host with natively integrated wallet to support pay-per-use payments

License

Notifications You must be signed in to change notification settings

ekailabs/kuber

Repository files navigation

Kuber

A modular, context-aware chat interface that supports Model Context Protocol and pay-per-use payments through x402

Kuber is an open-source desktop application built with Electron and React that provides an interface for interacting with AI models while supporting blockchain transactions through an integrated wallet. The application features a plugin-style architecture supporting multiple AI providers, MCP (Model Context Protocol) servers, and wallet types.

Features

  • Multi-Provider model Support: OpenAI, Anthropic, OpenRouter, Ollama, and more
  • Integrated Wallet: Native support for EVM-compatible wallets with secure key storage
  • MCP Integration: Connect to Model Context Protocol servers for extended functionality
  • Pay-per-Use: Support for x402 protocol payments for premium AI services
  • Workspace Management: Organize projects with file system integration
  • Artifact System: Generate and preview plots, charts and other visualization
  • Security First: OS-native secure storage for private keys and API keys

Prerequisites

  • Node.js 18 or later
  • npm 8 or later
  • Git

Development Setup

  1. Clone the repository:
git clone https://github.com/ekailabs/kuber.git
cd kuber
  1. Install dependencies:
npm install
  1. Start the development server:
npm start

Quick Start

Installation

  1. Clone the repository:

    git clone https://github.com/ekailabs/kuber.git
    cd kuber
  2. Install dependencies:

    npm install
  3. Start the development server:

    npm start

First Run Setup

  1. Configure AI Provider: Choose from OpenAI, Anthropic, OpenRouter, or Ollama
  2. Set API Keys: Securely store your provider API keys
  3. Create Workspace: Set up your first project workspace
  4. Optional - Wallet Setup: Import or generate an EVM wallet for blockchain features

Configuration

AI Providers

OpenAI / Anthropic / OpenRouter

  1. Get your API key from the provider
  2. Select the provider in Kuber
  3. Enter your API key (stored securely in OS keychain)
  4. Choose your preferred model

Ollama (Local Models)

  1. Install Ollama from https://ollama.ai/
  2. Start Ollama service: ollama serve
  3. Pull a model: ollama pull llama2
  4. In Kuber, select "Ollama" and connect to http://localhost:11434

MCP Servers

Kuber automatically connects to essential MCP servers:

  • Web Search: Enabled by default for internet search capabilities
  • File System: Automatically configured for each workspace
  • Other MCP Servers: Add your own MCP servers via Settings

Wallet Configuration

  • Import Existing: Use your existing private key or seed phrase
  • Generate New: Create a new wallet with secure key generation

Architecture

Kuber is built with a modular architecture that makes it easy to extend:

Core Components

  • Frontend: React with Material-UI components
  • Backend: Electron main process with IPC communication
  • State Management: React Context API
  • AI Integration: LangChain agents with MCP support similar to mcp-use-ts
  • Wallet: Viem for EVM interactions with secure key storage
  • Storage: OS-native secure storage (Keychain/Credential Manager)

MCP Integration

The MCP (Model Context Protocol) integration is inspired by mcp-use-ts, providing:

  • Tool discovery and registration
  • Secure tool execution
  • Multiple transport modes (stdio, HTTP)

Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Workflow

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/fire-feature)
  3. Make your changes with tests
  4. Commit your changes (git commit -m 'Add fire feature')
  5. Push to the branch (git push origin feature/fire-feature)
  6. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • mcp-use-ts - Inspiration for MCP agent architecture
  • gemini-cli - Inspiration for memory tool implementation
  • x402 - Pay-per-use HTTP payment protocol by Coinbase
  • Model Context Protocol - Protocol specification
  • The open-source community for the amazing tools and libraries

Support


Built with ❤️ by Ekai Labs

About

A MCP host with natively integrated wallet to support pay-per-use payments

Resources

License

Contributing

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •  

Languages