MCPcopy Index your code
hub / github.com/ArtisanCloud/PowerX

github.com/ArtisanCloud/PowerX @v1.0.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.0.2 ↗ · + Follow
20,828 symbols 52,113 edges 1,811 files 4,480 documented · 22%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

PowerX – Enterprise-Grade AgentOS (Agent Operating System)

中文 Official Docs License

PowerX is an enterprise-grade Agent Operating System (AgentOS) centered on plugin-based intelligent agents. Through AI Agent orchestration, plugin ecosystem, and unified protocols, it enables enterprise business modules (CRM, e-commerce, SCRM, approval workflows, etc.) to collaborate and evolve autonomously as intelligent agents.

PowerX = AI Agent Orchestration Kernel + Plugin Marketplace + MCP/gRPC/REST Multi-Protocol Unity


🌟 Screenshots

Management Dashboard

Management Dashboard

Plugin Marketplace

Plugin Marketplace


🏗️ Architecture Philosophy

PowerX is an enterprise-grade AgentOS (Agent Operating System) following three core principles:

1. Minimal Kernel

  • The kernel only provides universal capabilities: Identity & Organization (IAM), Role-Based Access Control (RBAC), Event Bus, Audit, Database Abstraction (DB Layer), and Runtime Flow Engine
  • These capabilities are exposed as an SDK (pkg/corex/*), which can be reused by any plugin and external system

2. Agent-First

  • All business functionality (e-commerce, SCRM, approval workflows, live streaming, etc.) exists as AI Agent intelligent agents
  • Agents connect to the kernel through Contracts, enabling independent development, deployment, and database schemas
  • Agents can be developed by official/3rd-party/customer teams and distributed through the Plugin Marketplace, supporting autonomous learning and collaboration

3. Contract-Driven + AI-Native

  • Plugins do not directly depend on each other, but are decoupled through Contract Interfaces / Event Subscriptions
  • Supports MCP (Model Context Protocol) for standardized AI tool integration
  • All external interfaces (HTTP/gRPC), events (Event Topics), and data models (OpenAPI/Proto) are centrally managed in the /contracts directory
  • Built-in toolchains automatically generate SDKs (Go/TypeScript), ensuring frontend-backend consistency

🔑 Core Components

Component Description Key Features
IAM (Identity & Organization) Users, departments, roles, tags Shared organizational architecture across all plugins
RBAC (Role-Based Access Control) Unified permission model (Role/Policy) Extensible to plugin level: plugins only declare "resources and actions", authorization managed by the kernel
Event Bus Primary communication mechanism between plugins Supports Local/Redis implementation, plugins only subscribe to Topics without caring about message sources
Audit (Audit Logs) Unified collection of all events/operations Kernel-level extensibility for compliance (security/risk control)
DB Layer (Database Abstraction) Multi-tenant isolation (Tenant) Plugin-independent schemas but shared Postgres/MySQL instances, unified migration tool (Goose compatible)
Flow (Business Process Engine) Built-in orchestratable execution flows (Plan/Task/Node) Plugins can mount custom Flow nodes
Agent Lifecycle & Observability Complete control plane covering agent registration, activation, pause, scaling, and retirement (HTTP / gRPC) Built-in health score aggregation, trend queries, subscription filtering, and enterprise IM alerting with 13-month retention

🔌 Plugin Mechanism

Plugin Structure

plugin-package/
├── plugin.yaml          # Plugin metadata
├── backend/             # Backend executable
│   └── main
├── web-admin/           # Frontend resources
│   ├── pages/
│   └── assets/
└── contract/            # Contract definitions
    └── api.yaml

Plugin Lifecycle

  • Install: Place plugin packages in the /plugins directory
  • Register: System automatically scans and registers plugins at startup
  • Load: Dynamically load plugin menus and pages
  • Communicate: Collaborate with other plugins through Event Bus or Contract Interfaces

🖥️ Multi-Frontend Support

PowerX includes four types of frontend shells, sharing unified contracts with auto-generated SDKs, supporting multiple protocols and frameworks:

Frontend/Protocol Use Case Features
Admin Dashboard Operations/management personnel Dynamic menu and plugin page loading
Web User Frontend C-end user interface Responsive design, multi-platform support
MiniApp Lightweight engagement scenarios WeChat/Alipay mini-program support
OpenAPI Third-party systems RESTful API unified calling interface
MCP (Model Context Protocol) AI Agent and plugin interaction Standardized AI tool integration protocol
gRPC High-performance inter-service communication Protobuf-based efficient RPC

📚 Documentation Resources

For detailed installation, deployment, and usage guides, please refer to:


🤝 Contributing

We welcome all forms of contribution!

Contributors

Thanks to all developers who contribute to PowerX! 🙏


📄 License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details


🏆 Acknowledgments

Thanks to all developers, designers, and users who support the PowerX project!


⭐ If this project is helpful to you, please give us a Star!

👉 One-line Summary: PowerX is an enterprise-grade AgentOS (Agent Operating System) that enables business modules like CRM, SCRM, e-commerce, and approval workflows to coexist and collaborate as AI intelligent agents through MCP/gRPC/REST multi-protocol unity, achieving autonomous learning and evolution while significantly reducing operational costs and providing standardized extension points.

Extension points exported contracts — how you extend this code

TaskDriver (Interface)
TaskDriver 定义统一任务驱动接口(enqueue/dequeue/ack/nack/retry)。 T065 先建立契约,后续任务再接入具体实现与运行时装配。 [8 implementers]
backend/pkg/event_bus/interface.go
ManifestValidator (Interface)
ManifestValidator 定义 manifest 校验器。 [17 implementers]
backend/internal/service/agent_lifecycle/autoreg.go
Provider (Interface)
(no doc) [3 implementers]
web-admin/app/composables/api/services/aiSettingService.ts
BaseRepository (Interface)
BaseRepository 基础仓储接口 定义了通用的数据访问操作方法
backend/domain/repository/base_repository.go
Sink (Interface)
Sink:旁路(日志、总线…) [22 implementers]
backend/pkg/corex/audit/service.go
SandboxRunner (Interface)
SandboxRunner 定义沙箱执行器。 [11 implementers]
backend/internal/service/agent_lifecycle/autoreg.go
ApiClientConfig (Interface)
========================= * API 客户端配置 * ========================
web-admin/app/composables/api/index.ts
PageRepository (Interface)
PageRepository 分页查询接口 扩展基础仓储接口,提供分页查询功能
backend/domain/repository/base_repository.go

Core symbols most depended-on inside this repo

Error
called by 1159
backend/internal/server/mcp/errors/errors.go
Context
called by 911
backend/internal/transport/grpc/auth/middleware/auth_interceptor.go
WithContext
called by 846
backend/pkg/utils/logger/manager.go
Is
called by 579
backend/pkg/plugin_mgr/errors.go
String
called by 541
backend/internal/service/event_fabric/authorization/cache.go
String
called by 392
backend/internal/transport/http/admin/capability_registry/dto/error.go
JSON
called by 356
backend/internal/server/agent/schemas/sanitize.go
String
called by 286
backend/cmd/event_fabric_seed/main.go

Shape

Method 10,925
Function 5,564
Struct 3,488
Interface 679
TypeAlias 121
FuncType 27
Class 20
Enum 4

Languages

Go94%
TypeScript6%
Rust1%

Modules by API surface

backend/api/grpc/gen/go/powerx/knowledge/v1/knowledge_space.pb.go708 symbols
backend/api/grpc/gen/go/powerx/agent_model_hub/v1/agent_model_hub.pb.go441 symbols
backend/api/grpc/gen/go/powerx/integration_gateway/v1/integration_gateway.pb.go438 symbols
backend/api/grpc/gen/go/powerx/workflow/v1/workflow.pb.go403 symbols
backend/api/grpc/gen/go/powerx/event_fabric/v1/event_fabric.pb.go369 symbols
backend/api/grpc/gen/go/powerx/agent/v1/agent_lifecycle.pb.go363 symbols
backend/api/grpc/gen/go/powerx/setting/ai_setting.pb.go349 symbols
backend/api/grpc/gen/go/powerx/platform_ops/v1/ops_admin.pb.go283 symbols
backend/api/grpc/gen/go/powerx/capability/registry/v1/registry.pb.go283 symbols
backend/api/grpc/gen/go/powerx/plugin_release/v1/plugin_release.pb.go252 symbols
backend/api/grpc/gen/go/powerx/media/v1/media_asset.pb.go213 symbols
backend/api/grpc/gen/go/powerx/capability/v1/capability_contract.pb.go201 symbols

Datastores touched

powerxDatabase · 1 repos

For agents

$ claude mcp add PowerX \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page