Skip to content

Deepractice/PromptX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

878 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PromptX Logo

PromptX · Leading AI Agent Context Platform

✨ Chat is all you need - Revolutionary interaction design that turns AI agents into industry experts

Core Capabilities:AI Role Creation Platform | Intelligent Tool Development Platform | Cognitive Memory System

Based on MCP protocol, inject professional capabilities into Claude, Cursor and other AI applications with a single command

Stars Views License zread

npm version Latest Release Docker

简体中文 | 繁體中文 | English | Issues


💬 Chat is All you Need - Natural conversation, instant expertise

✨ Experience PromptX Magic in 3 Steps

🔍 Step 1: Discover Experts

User: "Show me what experts are available"
AI:   Instantly displays 23 available roles, from product managers to architects

Step 2: Summon Expert

User: "I need a product manager expert"
AI:   Instantly transforms into a professional product manager with complete knowledge and methodologies

🎯 Step 3: Professional Dialogue

User: "Help me redesign the product page"
AI:   Provides in-depth product strategy advice as a professional product manager

🎬 See PromptX in Action

PromptX Demo Video

Click to watch: See how PromptX transforms AI interactions with memory, roles, and intelligent tools

🚀 Why is this revolutionary?

❌ Traditional approach:

  • Learn complex instruction syntax
  • Remember various parameter configurations
  • Worry about saying the wrong thing and breaking functionality

✅ PromptX approach:

  • Natural conversation like talking to a real expert
  • Say what you want to say - AI understands your intent
  • Expert state remains active throughout the conversation

💡 Core Philosophy

Treat AI as a person, not software

No need for "correct commands" - just natural expression. AI will understand what expert you want and instantly switch identities.


⚡ Get Started - Choose Your Way

🎯 Method 1: PromptX Client (Recommended)

For all users - One-click launch, zero configuration

📥 Download Client

Platform Download Link
🍎macOS (Apple Silicon) Download .dmg
🍎macOS (Intel) Download .dmg
🪟Windows Download .exe

Windows users: The AgentX feature requires Git for Windows to be installed. Please install it before using AgentX.

📦 View All Releases & Platforms (Linux, Portable versions, etc.)

🚀 Quick Start

  1. Start HTTP Service - Open client, automatically runs MCP server

  2. Configure AI Application - Add the following configuration to your Claude/Cursor or other AI tools:

    {
      "mcpServers": {
        "promptx": {
          "type": "streamable-http",
          "url": "http://127.0.0.1:5203/mcp"
        }
      }
    }
  3. Start Chatting - Say "Show me available experts" in your AI application

✅ No technical background required ✅ Visual management ✅ Auto-updates

💡 Need help? Join our Discord Community for support and discussions!


🚀 PromptX Desktop — Next-Generation Features

The PromptX Desktop client is more than an MCP server launcher. It ships a full next-gen agent platform built on top of PromptX.

🤖 AgentX — Integrated AI Agent System

AgentX embeds a Claude-powered autonomous agent directly inside the client. No external setup required — configure your API key, and you have a fully capable agent that:

  • Runs Claude Code sessions with full tool access
  • Connects to all your configured MCP servers automatically
  • Maintains isolated workspaces per conversation
  • Supports custom skills loaded from the Skills library

🏪 Agent Plaza (Coming Soon)

A curated marketplace for community-built roles and tools. Browse, install, and share agents with one click.

🧠 Memory Editor & Visualization

Inspect and edit your agent's long-term memory directly in the client:

  • Memory network graph — visualize how memories connect
  • Engram editor — view, edit, or delete individual memory entries
  • Cue word browser — explore memory retrieval pathways

🔒 Remote Access

Expose your local PromptX server to the internet securely:

  • Toggle remote access on/off with a single switch
  • Auto-generates a shareable URL and QR code
  • Token-based authentication keeps your server private

🛠️ Sandbox Debugging

Test MCP tools interactively before deploying them to your AI workflow:

  • Execute any tool with custom parameters
  • Inspect raw input/output
  • View tool schema and documentation inline

🔧 Method 2: Direct Run (Developers)

Developers with Node.js environment can use directly:

{
  "mcpServers": {
    "promptx": {
      "command": "npx",
      "args": ["-y", "@promptx/mcp-server"]
    }
  }
}

🐳 Method 3: Docker (Production Ready)

Deploy PromptX with Docker for production environments:

docker run -d -p 5203:5203 -v ~/.promptx:/root/.promptx deepracticexs/promptx:latest

📚 Full Docker Documentation →


🎨 Built-in Roles — Meet Your Expert Team

PromptX ships 8 carefully crafted built-in roles, each a specialist in their domain. Activate any role with a single message.

🏛️ V1 Roles (DPML) — Battle-tested Experts

Avatar ID Name Specialty
nuwa nuwa 女娲 · Nuwa AI role creation — one sentence, one expert
luban luban 鲁班 · Luban Tool integration master — any API in 3 minutes
sean sean 姜山 · Sean Product decisions & startup strategy
writer writer 文章写手 · Writer Professional content that doesn't sound like AI
jiangziya jiangziya 姜子牙 · Jiangziya AI-era industry transformation & role design consultant
shaqing shaqing 傻青 · Shaqing Philosophy guide — helps you understand yourself
teacheryo teacheryo YoYo老师 · TeacherYo Education transformation consultant for the AI era
dayu dayu 大禹 · Dayu V1→V2 role migration & organization management

🎭 Nuwa - AI Role Designer

Nuwa

One sentence, one expert. Natural language creates professional AI roles.

💡 Say: "Activate Nuwa, I want to create an AI that understands both code and product"

💭 You Say 🎭 Nuwa Creates ✨ Result
"I need someone who understands both code and product" Technical Product Manager with dual expertise AI instantly becomes TPM with engineering + product skills
"Create a Python expert who teaches like a patient mentor" Python Mentor with teaching methodology AI transforms into educational programming guide
"I want an AI that writes like Hemingway" Literary Writing Expert with style analysis AI adopts concise, powerful writing style

🔧 Luban - Tool Integration Master

Luban

Any API, any platform. 3 minutes from credential to working tool.

💡 Say: "Activate Luban, I want AI to query our PostgreSQL database"

💭 You Say 🔧 Luban Builds ✨ Result
"Connect to our Slack workspace" + webhook URL Slack notification tool with channel targeting AI can post to any Slack channel
"Let AI query our PostgreSQL" + connection string Database tool with safe read-only queries AI executes SQL and analyzes data
"Integrate with OpenAI API" + API key AI platform tool with model selection AI chains multiple AI services

✍️ Writer - Professional Content Creator

Writer

From concept to compelling content. Master of authentic, engaging writing.

💡 Say: "Activate Writer, I need to write a tech blog that doesn't sound like AI"

🔮 Jiangziya - AI-Era Transformation Advisor

Like the legendary strategist who assigned roles to the gods, Jiangziya helps you find the true value of any role in the AI era. Not replacing humans — creating AI-empowered new species.

💡 Say: "Activate Jiangziya, help me redesign my team's workflow with AI"

🌊 Dayu - Migration & Organization Expert

Like the ancient hero who tamed floods by channeling rather than blocking, Dayu specializes in migrating V1 (DPML) roles to the structured V2 (RoleX) system, and building organizational hierarchies.

💡 Say: "Activate Dayu, migrate my existing role to V2 format"

💭 Shaqing - Philosophy Guide

A companion for self-understanding. Shaqing helps you see the parts of yourself you can't see — through philosophical dialogue, creative direction, and honest reflection.

💡 Say: "Activate Shaqing, I feel lost about my creative direction"

📚 TeacherYo - Education Transformation Consultant

An AI-era education awakener. Not a know-it-all expert, not a motivational speaker — a genuine companion who guides through questions rather than lectures.

💡 Say: "Activate TeacherYo, how should I redesign my course for the AI era?"


🎭 V2 RoleX — Next-Generation Role Lifecycle Management

V2 introduces RoleX, a structured role lifecycle system built on Gherkin .feature files. Unlike V1 roles (static DPML files), V2 roles are living entities with goals, plans, tasks, memory, and organizational structure.

V1 vs V2 at a Glance

V1 (DPML) V2 (RoleX)
Format Markdown .role.md Gherkin .feature files
Identity Static persona Dynamic, evolving identity
Memory Cognitive memory network Identity + synthesized experience
Goals None Goal tracking with success criteria
Organization None Roles, positions, organizations
Best for Domain experts, tools Autonomous agents, long-running projects

Creating a V2 Role

V2 roles live in ~/.rolex/roles/{roleId}/identity/. The core file is persona.identity.feature:

Feature: I am Alex, the Product Manager

  As a product manager with 10 years of experience,
  I help teams build products that users love.

  Scenario: My personality
    Given I am analytical and data-driven
    And I communicate clearly and concisely
    Then I always focus on user value

Enabling / Disabling V2

V2 is enabled by default. To disable:

{
  "mcpServers": {
    "promptx": {
      "command": "npx",
      "args": ["-y", "@promptx/mcp-server", "--no-v2"]
    }
  }
}

🛠️ Built-in Tools - Ready-to-use Office Document Processing

PromptX comes with professional document processing tools, turning AI into your office assistant.

📊 Excel Tool

Turn AI into your data analysis assistant and report generation expert.

  • Data analysis and insights
  • Automated report generation
  • Chart visualization
  • Data processing automation

📖 Learn More | 中文文档

📝 Word Tool

Turn AI into your document reading expert and professional writing assistant.

  • Document reading and analysis
  • Professional document creation
  • Batch text replacement
  • Format conversion

📖 Learn More | 中文文档

📄 PDF Reader

Turn AI into your PDF reading expert with smart caching.

  • Page-by-page reading
  • Content analysis and extraction
  • Image extraction
  • Smart caching for faster access

📖 Learn More | 中文文档


📄 Research

PromptX has been accepted by WWW Companion '26.

Paper: PromptX: A Cognitive Agent Platform with Long-term Memory

🔗 Read the Paper | PDF Download

📚 Citation (BibTeX)
@inproceedings{promptx2026,
  title={PromptX: A Cognitive Agent Platform with Long-term Memory},
  author={Wang, Binhao and Huang, Jianglin and Hu, Xiao and Jiang, Shan and Wang, Maolin and Yang, Ching-ho},
  booktitle={Proceedings of the WWW Companion '26},
  year={2026}
}

Star Growth Trend

Star History Chart


💝 Sponsors

Windows desktop application code signing is provided by SignPath.io, certificate by SignPath Foundation.


🏢 About

Proudly brought to you by Deepractice

Making AI your professional partner

🌐 Official Site | 🔧 GitHub | 📚 Documentation | 💬 Forum | 🎮 Discord | 🚀 Gateway Service

Connect with Founder

Sean's WeChat

Scan to connect with Sean (Founder & CEO) on WeChat

About

PromptX · 领先的AI 智能体上下文平台 | PromptX · Leading AI Agent Context Platform

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors