FP

PyPI Python License

简介

FP 是一个基于生命周期钩子的插件化 Agent 框架。它提供了灵活、可扩展的方式来构建和运行 AI Agent，支持终端 REPL、Web 界面和远程协议调用等多种交互方式。

灵感来源于《Rain World》中的迭代器「五块卵石」—— 冷静、理性、追求优雅的解决方案。

特性

  • 🤖 强大的 Agent 引擎 — 基于生命周期钩子，在 Agent 运行的各个阶段注入自定义逻辑
  • 🔌 插件化架构 — 通过插件动态扩展工具、命令和行为，无需修改核心代码
  • 🖥️ 终端 REPL — 交互式命令行界面，语法高亮、自动补全、流式输出
  • 🌐 Web 界面 — 浏览器端图形界面，开箱即用
  • 🔗 ACP 协议 — JSON-RPC 2.0 远程调用，轻松集成 IDE、CI/CD、其他 Agent

快速安装

基本安装（核心 + CLI）

pip install fp-agent

安装后即可使用终端 REPL：

fp

安装所有组件

pip install fp-agent[all]

选择性安装

# 核心 + Web 界面
pip install fp-agent[webui]

# 核心 + ACP 协议
pip install fp-agent[acp]

要求 Python >= 3.11。

Windows 用户：推荐安装 Git for Windows（安装时勾选"Git Bash"并添加到 PATH），以获得完整的 Unix 命令支持。未安装时会自动降级到 cmd.exe，仅支持 Windows 原生命令。

快速使用

终端 REPL（默认）

fp

进入交互式对话：

>> 请用 Python 写一个斐波那契数列生成器

离线文档

fp docs            # 打开随包安装的离线文档目录
fp docs --list     # 列出文档目录树
fp docs --path     # 仅打印文档路径

离线文档随包分发在 site-packages/fp/docs/，无网络时也可查阅。

Web 界面

pip install fp-agent[webui]
fp --webui

浏览器访问 http://localhost:7860。

ACP 远程调用

pip install fp-agent[acp]
fp --acp

然后通过 JSON-RPC 调用：

curl http://localhost:9090 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"chat","params":{"message":"你好"}}'

配置

命令行选项

fp [OPTIONS]

选项：
  --config FILE        指定配置文件路径
  --webui             启动 Web 界面模式
  --acp               启动 ACP Server 模式
  --model NAME        指定 LLM 模型名称
  --host HOST         监听地址（默认 127.0.0.1）
  --port PORT         监听端口
  --debug             启用调试模式
  --quiet             静默模式
  --version           显示版本信息

配置文件

默认读取 ~/.config/fp/config.yaml：

llm:
  provider: openai
  model: gpt-4o
  temperature: 0.7
  api_key: ${OPENAI_API_KEY}

session:
  storage: file
  path: ~/.local/share/fp/sessions

plugins:
  - my_plugin

cli:
  theme: dark
  stream: true

项目结构

fp                          # 主包（用户入口）
├── fp-core                 # 核心引擎（Agent 逻辑、LLM 交互、插件系统）
├── fp-terminal              # 终端 REPL 界面
├── fp-webui                # Web 界面
└── fp-acp                  # ACP 通信协议（JSON-RPC 2.0）

文档

依赖

依赖 版本 说明
fp-core >= 0.1.0 Agent 核心引擎（必装）
fp-terminal >= 0.1.0 终端 REPL（必装）
fp-webui >= 0.1.0 Web 界面（可选）
fp-acp >= 0.1.0 ACP 协议（可选）

许可

MIT © zpb

Project links

Data verified by PyPI on Aug 3, 2026
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.13)

1 maintainer

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

Credits

Author: zpb

GitHub Statistics

Data verified by PyPI on Aug 3, 2026
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 expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

webui acp all

Tags

agent llm lifecycle plugin ai

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

fp_agent-0.1.12.tar.gz (154.1 kB view details)

Uploaded Source

Built Distribution

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

fp_agent-0.1.12-py3-none-any.whl (175.9 kB view details)

Uploaded Python 3

File details

Details for the file fp_agent-0.1.12.tar.gz.

File metadata

  • Download URL: fp_agent-0.1.12.tar.gz
  • Upload date:
  • Size: 154.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for fp_agent-0.1.12.tar.gz
Algorithm Hash digest
SHA256 f8615de2c704ff692840e53dd573ec147359ac0540e0579d4d5332bdb015142b
MD5 3c2ec98f228e3fba18e7f87e34cbc939
BLAKE2b-256 db555c37a124885f68f32fbe8d4ef0f4b4e37c2ac02cc99c3f7f3eb21d19583a

See more details on using hashes here.

Provenance

The following attestation bundles were made for fp_agent-0.1.12.tar.gz:

Publisher: release.yml on zpb911km/fp-agent

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

File details

Details for the file fp_agent-0.1.12-py3-none-any.whl.

File metadata

  • Download URL: fp_agent-0.1.12-py3-none-any.whl
  • Upload date:
  • Size: 175.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for fp_agent-0.1.12-py3-none-any.whl
Algorithm Hash digest
SHA256 1549c5cc57d172a601eb2a16c2fcc7f64a3c38becd60767849c58306c730a091
MD5 45a5aa70e96e0a6b389a846f3b4c91e0
BLAKE2b-256 e15e0f67b3e8d8bf54e4f9cf8c5d1264e421770fe4c22426a3a4e396186bf1bf

See more details on using hashes here.

Provenance

The following attestation bundles were made for fp_agent-0.1.12-py3-none-any.whl:

Publisher: release.yml on zpb911km/fp-agent

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

Release history Release notifications | RSS feed

0.1.13

2 files

This release

0.1.12 This release

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

Pre-release

0.1.1.dev0

2 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