mens

Agent framework with built-in tools, MCP integration, and CLI.

Install

pip install mens[all]

需要 Python 3.12+ 才能在 TUI 里显示图片（textual-image 的下界）；3.10/3.11 上 图片降级成文本占位，其余功能不受影响。

本地开发

日常开发用 conda py12，它同时 editable 装了 mens 和 flexllm——改 flexllm 的代码 立刻在 mens 里生效，两个项目能联调（mens 的语音、多模态都依赖 flexllm 的新能力）。

conda activate py12
pip install -e ".[all,dev]"    # 只做一次
pytest -q                      # 500 passed

.venv（uv）只用于发版前验证，别拿它做日常开发：

uv sync && uv run pytest -q

两者测的不是同一件事：py12 里依赖是本地 editable 的，验证"我改的代码对不对"；.venv 按 uv.lock 装 PyPI 版本，验证"用户 pip install mens 拿到的组合能不能跑"—— flexllm>=0.9.0 这类下界是真是假，只有后者测得出来。CI（release.yml）跑的也是 uv。

代价是两套环境会漂移，而且症状是功能静默降级、不是报错：flexllm 本地加了新功能而 .venv 里还是 PyPI 旧版，两边版本号却一样。动手前先确认自己在哪个环境：

python -c "import flexllm, mens; print(flexllm.__file__); print(mens.__file__)"
# 指向 ~/github/... = py12（可联调）；指向 .venv/site-packages = 发布形态

Quick Start

from flexllm import LLMClient
from mens import AgentClient

llm = LLMClient(model="gpt-4o")
agent = AgentClient(llm)
result = await agent.run("读取 main.py 并分析")

CLI

mens run "查一下 cpu 使用率"          # 非交互执行（支持 stdin 管道）
mens run --tools code "读取 main.py"
mens chat                             # 交互式全屏 TUI
mens chat -c                          # 恢复最近会话
mens sessions list                    # 会话管理

程序 / AI Agent 调用

mens run 是给自动化用的入口：stdout 是结果、stderr 是过程，退出码表达成败。

mens info                                          # 自描述：工具/skill/退出码（JSON）
mens run "任务" --format json                       # 完整执行记录
mens run "任务" --format json || echo "失败: $?"    # 0 成功 / 2 参数错 / 5 未完成

跨调用多轮：--session <id> 新建会话、--resume <id> 续接（分开是为了让"撞上同名旧会话" 报错而不是静默接上陌生上下文）。

退出码与 JSON 字段的完整契约见 docs/agent-cli.md。

给 Claude Code 等 AI agent 用时，先装 skill 让它一次拿到心智模型，不必逐层 --help 摸索：

mens install-skill        # → 软链到 ~/.claude/skills/mens/（重开会话后生效）

软链而非复制：升级 mens 后 skill 自动跟着更新，不必记得重装。

交互式 TUI（mens chat）

全屏终端界面：流式输出、工具调用卡片、斜杠命令（/help /clear /compact /model /resume …）、 Esc 中断当前任务、↑/↓ 输入历史、Tab @路径 补全（界面显示短路径，发给模型时展开成绝对路径）。

  • 权限：默认 default 模式（只读放行，写操作弹窗审批），Shift+Tab 随时轮转 default → acceptEdits → bypass（bypass = 不再询问）；"总是允许"会把规则持久化到 .mens/settings.json（如 bash(git commit:*)）。详见 docs/permissions.md
  • 会话：每轮自动持久化（flaxkv2），-c/--resume 或 TUI 内 /resume 恢复。详见 docs/sessions.md

完整文档见 docs/。

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.7)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for K.y from gravatar.com K.y

Credits

Author: kunyuan

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache-2.0)

Requires

Python >=3.10

Provides Extra

all dev mcp serve

Tags

agent cli llm mcp tool-use

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mens-0.1.6.tar.gz (473.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mens-0.1.6-py3-none-any.whl (163.5 kB view details)

Uploaded Python 3

File details

Details for the file mens-0.1.6.tar.gz.

File metadata

  • Download URL: mens-0.1.6.tar.gz
  • Upload date:
  • Size: 473.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mens-0.1.6.tar.gz
Algorithm Hash digest
SHA256 721f41d2a45de30c8f0a551dc849b176f7ab60e0992f1984732058f8c42adb8f
MD5 5395e5f8824a40460276ef7b347854fc
BLAKE2b-256 559d7c16ba98f18646cbbfae3d500d676376c6835372679d886c6343da6f9737

See more details on using hashes here.

Provenance

The following attestation bundles were made for mens-0.1.6.tar.gz:

Publisher: release.yml on KenyonY/mens

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mens-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: mens-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 163.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mens-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 42252076aa9188f2194b0e1abe17f2469db2e5ff580354a7eb5c6e4d5c7f332f
MD5 03e6707557d024ec7f95744031f98e57
BLAKE2b-256 dbfa9d7f5dea4ac47ac8d12df530f68546dd7dd16c5e34b1e9c1e2a224811e8a

See more details on using hashes here.

Provenance

The following attestation bundles were made for mens-0.1.6-py3-none-any.whl:

Publisher: release.yml on KenyonY/mens

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page