Skip to main content

社交关系AI管家

本地运行的AI管家,自动追踪所有社交关系中「最近干了什么」和「下一步该干什么」。

License Version

安装

pip(推荐)

pip install social-agent

npm

npx @farmost/social-agent status

一键脚本

bash <(curl -sL https://raw.githubusercontent.com/farmost-beep/social-agent/main/install.sh)

已配置 Claude Code(~/.claude/settings.json)的用户无需额外设置,CLI 自动复用系统 LLM 配置。未配置则三选一:

# Claude(默认,无需额外设置 engine)
export ANTHROPIC_API_KEY=sk-ant-...

# OpenAI
export LLM_ENGINE=openai
export OPENAI_API_KEY=sk-...

# MiniMax
export LLM_ENGINE=openai
export OPENAI_API_KEY=...
export OPENAI_BASE_URL=https://api.minimaxi.com/v1

命令

social status                  # 联系人状态总览
social todos                   # 待办列表
social advise                  # 该联系谁+为什么+聊什么
social draft -m "上下文" -c 张三  # AI 拟稿
social chat "消息"              # 直接对话
social anchor                  # 目标锚定(联系人↔六维目标)
social outcomes                # 兑现追踪
social config show             # 查看配置

数据

本地 JSON 存储,不上云:

文件 说明
data/contacts.json 联系人库
data/timeline.json 互动时间线
data/todos.json 待办队列

文档

许可证

MIT

Release files for social-agent 4.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for social-agent 4.0.3
File Size Uploaded
social_agent-4.0.3.tar.gz 89.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for social-agent 4.0.3
File Interpreter ABI Platform
social_agent-4.0.3-py3-none-any.whl Python 3 none any Details

Total release size: 194.2 kB

Release files / social_agent-4.0.3.tar.gz

Download URL social_agent-4.0.3.tar.gz
Size 89.8 kB
Tags Source
SHA-256 checksum
How to use checksums
8f8d04dd90c157a06de98586fb58cfa2b7af55a034250cdfbdea75f69f9ba893
BLAKE2b-256 checksum
How to use checksums
e8511363f474431b2816b7ae66d89bc9e0577289657a0d966ec0d584a5c24bb8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release files / social_agent-4.0.3-py3-none-any.whl

Download URL social_agent-4.0.3-py3-none-any.whl
Size 104.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dd2b821c0bba3128cc71a19dde7b5e9deef22545571032f03ff7addc96757b45
BLAKE2b-256 checksum
How to use checksums
868904e1c84a0b88650175cdf6b5a1bedada5693dca7aa0493fa865b0c46e87d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release history Release notifications | RSS feed

This release

4.0.3 This release

2 release files

4.0.2

2 release files

4.0.1

2 release files

3.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page