Installation

Prerequisites

• Rust 1.88+ — needed for the core engine, MCP server, and CLI
• Python 3.10+ with uv — for the Python SDK
• Bun or Node.js 18+ — optional, for the TypeScript SDK
• Go 1.21+ — optional, for the Go SDK

Python SDK

pip install pensyve

Or build from source:

git clone https://github.com/major7apps/pensyve.git && cd pensyve
uv sync --extra dev
uv run maturin develop --manifest-path pensyve-python/Cargo.toml

Verify:

python -c "import pensyve; print(pensyve.__version__)"

TypeScript SDK

The TypeScript SDK is an HTTP client that talks to the REST API.

bun add pensyve

Or with npm:

npm install pensyve

Go SDK

go get github.com/major7apps/pensyve/pensyve-go

MCP Server

Build from source:

cargo install pensyve-mcp

Or from the repo:

cargo build --release --bin pensyve-mcp

The binary lands at ./target/release/pensyve-mcp. See MCP Setup for configuration.

CLI

cargo install pensyve-cli

Or from the repo:

cargo build --release --bin pensyve-cli

REST API Gateway

The Rust/Axum gateway serves REST and MCP on port 3000. Build it from the Pensyve repository:

git clone https://github.com/major7apps/pensyve.git && cd pensyve
cargo build --release -p pensyve-mcp-gateway
./target/release/pensyve-mcp-gateway

The TypeScript and Go SDKs connect to this gateway over HTTP. See the REST API Quick Start for requests and authentication.

Environment Variables