xAgent
xAgent is a local-first AI agent platform that gives each agent its own identity, memory, workspace, and ongoing life.
Interact with your agents through the terminal, Web UI, voice, or Weixin, and manage them from a unified interactive launcher.
Features
- Local-first — Agent data is stored on your own machine.
- Independent agents — Each agent has its own identity, memory, diary, workspace, skills, tasks, logs, and channel state.
- Multiple interfaces — Use xAgent from the terminal, Web UI, voice, or Weixin.
- Unified management — Create, configure, and manage agents from one interactive launcher.
- External execution — Connect hardware or software devices to the Agent API and call their declared capabilities through one generic tool.
Requirements
- Python 3.10 or later
Installation
Install with the official script
curl -fsSL https://raw.githubusercontent.com/ZJCODE/xagent/main/install.sh | bash
Install with pip
pip install myxagent
Getting Started
After installation, launch xAgent with:
xagent
The interactive launcher will guide you through creating and managing your agents.
New OpenAI and DeepSeek agents enable the matching web search service automatically, reusing the main API key. Other providers start with search disabled. You can change search in Agent setup; changing an existing agent's model provider preserves its search selection.
In the terminal launcher, choose Runtime → Start, then open Channel to connect Weixin or Voice. In the Web client, manage connections from Channels. Restart the Agent after changing its configuration or identity.
To add a hardware or software device, open Agent → Devices and follow the pairing steps. No configuration edits or restart are needed.
Learn more: Managing channels and restarts · Connecting devices.
Updating
Update xAgent without changing how it was installed:
xagent update
Local Data
All xAgent data is stored locally in:
~/.xagent/
Agent-specific data is stored under:
~/.xagent/agents/
Uninstallation
If xAgent was installed with the official installation script:
uv tool uninstall myxagent
If xAgent was installed with pip:
pip uninstall myxagent
Uninstalling the CLI does not delete data stored under:
~/.xagent/
Remove that directory manually only when you no longer need your local agent data.
License
xAgent is released under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for myxagent 0.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| myxagent-0.4.1-py3-none-any.whl | Python 3 | none | any | Details |
Release files / myxagent-0.4.1-py3-none-any.whl
| Download URL | myxagent-0.4.1-py3-none-any.whl |
|---|---|
| Size | 638.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
86dcd147452972da5b73bf9a7260721b48a1f4961cd5768c91169752da45237f
|
|
BLAKE2b-256 checksum How to use checksums |
c75623fb67e49a2b4e06d79346bdea8623a8c792e3f6edd202dd1a8541ba9324
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.13
|
Security for myxagent 0.4.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
