whatisgithub

What is purrfect-agent?

pieverse-eng/purrfect-agent — explained in plain English

Analysis updated 2026-05-18

136TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

An open-source TypeScript AI agent framework with built-in crypto and blockchain skills, runnable from a terminal, editor, or chat apps like Slack and Discord.

Mindmap

mindmap
  root((Purr-Fect Agent))
    What it does
      AI agent core
      Onchain skills
      Agent wallet
      Self-learning memory
    Tech stack
      TypeScript
      Node.js
      MCP
    Use cases
      Terminal agent
      Chat app bot
      Onchain automation
    Audience
      Developers
      Crypto builders
    Setup
      npm install and build
      Run purrfect setup
      Onboard wallet

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a general-purpose AI agent from a terminal, code editor, or chat app.

USE CASE 2

Give an agent onchain skills to interact with exchanges like Binance or OKX.

USE CASE 3

Provision an agent wallet for signing and executing blockchain transactions.

USE CASE 4

Host a chat-app AI agent on Slack, Discord, Telegram, or LINE.

What is it built with?

TypeScriptNode.jsSQLiteMCP

How does it compare?

pieverse-eng/purrfect-agentwebdevsimplified/react-multistep-formtestsprite/testsprite-cli
Stars136138140
LanguageTypeScriptTypeScriptTypeScript
Last pushed2023-10-07
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Node 20+, onchain write skills require provisioning a real crypto wallet.

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

So what is it?

Purr-Fect Agent is an open source command line AI agent framework built in TypeScript, described by its authors as the same tool they use internally at a company called Pieverse, now released publicly. At its core it is a general purpose AI agent that can be run from a terminal, embedded in a code editor, or connected to chat platforms like Slack, Discord, Telegram, and LINE, all sharing the same underlying agent engine rather than being separate implementations for each surface. What sets this project apart from a generic agent framework is that it ships with a large built in library of over 140 skills for interacting with cryptocurrency exchanges and blockchain services, covering platforms like Binance, OKX, PancakeSwap, OpenSea, and several blockchain networks. Setting the tool up can also provision a dedicated crypto wallet for the agent to use, which is required for any skill that needs to sign transactions, send funds, or execute trades, though read only skills work without a wallet. The agent also has a self learning component, where it can save notes and preferences to memory files that get automatically included in future sessions, so context is not lost between conversations. Getting started involves cloning the repository, installing dependencies and building the project with npm, and then running an interactive setup command that configures the AI provider connection, installs the exchange and blockchain skills, and optionally sets up the crypto wallet. The tool defaults to routing AI requests through Pieverse's own gateway service, but this can be pointed at any OpenAI compatible endpoint or directly at Anthropic's API instead. Beyond the command line, it can also run as an HTTP API server, host scheduled background tasks, and support multiple separate agent profiles on a single installation, each with its own memory and settings. The project describes itself as MIT licensed and notes it currently has roughly 1150 tests, but is explicitly labeled an early alpha release, meaning its interfaces and stored data formats may still change before reaching a stable version.

Copy-paste prompts

Prompt 1
Help me run purrfect setup and connect it to my preferred AI provider.
Prompt 2
Explain what onchain skills purrfect installs and what they let the agent do.
Prompt 3
Walk me through onboarding an agent wallet with Purr-Fect Claws.
Prompt 4
Help me set up the purrfect gateway to run on Slack or Discord.
Prompt 5
How does purrfect's memory system carry context between sessions?

Frequently asked questions

What is purrfect-agent?

An open-source TypeScript AI agent framework with built-in crypto and blockchain skills, runnable from a terminal, editor, or chat apps like Slack and Discord.

What language is purrfect-agent written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, SQLite.

What license does purrfect-agent use?

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

How hard is purrfect-agent to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is purrfect-agent for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.