Metadata-Version: 2.4
Name: myxagent
Version: 0.3.2
Summary: Multi-Modal AI Agent System
Author-email: ZJun <zhangjun310@live.com>
Project-URL: Repository, https://github.com/ZJCODE/xagent
Project-URL: Issues, https://github.com/ZJCODE/xagent/issues
Project-URL: Homepage, https://github.com/ZJCODE/xagent#readme
Keywords: ai,agent,openai,chatbot,async
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.116.1
Requires-Dist: pydantic>=2.11.7
Requires-Dist: uvicorn>=0.35.0
Requires-Dist: openai>=1.98.0
Requires-Dist: anthropic>=0.64.0
Requires-Dist: langfuse>=3.0.0
Requires-Dist: cryptography>=42.0.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: requests>=2.32.0
Requires-Dist: trafilatura>=2.0.0
Requires-Dist: lxml[html-clean]>=5.0.0
Requires-Dist: lark-oapi>=1.5.5
Requires-Dist: qrcode[pil]>=7.4.2
Requires-Dist: pillow>=10.0.0
Requires-Dist: posthog>=3.6.0
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: python-multipart>=0.0.20
Requires-Dist: readchar>=4.2.1
Requires-Dist: rich>=13.9.4
Requires-Dist: sounddevice>=0.5.0
Requires-Dist: python-socks>=2.4.0
Requires-Dist: tenacity>=9.1.2
Requires-Dist: watchdog>=6.0.0
Requires-Dist: websockets>=14.0
Dynamic: license-file

# xAgent

[![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](https://www.python.org/)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

xAgent is a local-first personal AI agent. Use it from the terminal, Web UI, voice, Feishu, or Weixin, and manage everything from one interactive launcher.

## Install

```bash
pip install myxagent
```

## Start

Run:

```bash
xagent
```

The launcher will guide you through the rest

For most users, `xagent` is the only command you need to remember.
To create or reconfigure an agent directly, run `xagent setup`.
To start the voice channel directly, run `xagent voice`.

## What xAgent Gives You

- A terminal chat for quick conversations.
- A Web UI for longer conversations, files, memory, tasks, skills, and workspace browsing.
- A voice channel for microphone and speaker interaction.
- Background channels for Web/API, voice, Feishu, and Weixin.
- Multiple named agents, each with its own identity, memory, workspace, tasks, skills, logs, and channel state.

## Local Data

xAgent stores your agents locally under:

```text
~/.xagent/agents/
```

Each agent has its own config, identity, memory, messages, workspace, skills, tasks, logs, and channel process files.

## Contributing

xAgent is open source and in active development. Issues, bug reports, and pull requests are welcome.

- Repository: https://github.com/ZJCODE/xagent
- Issues: https://github.com/ZJCODE/xagent/issues

For local development:

```bash
python -m pip install -e .
python -m pytest
```

## License

xAgent is released under the MIT License. See [LICENSE](LICENSE).
