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 Sep 8, 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:
Latest release

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 Sep 8, 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.13.tar.gz (169.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.13-py3-none-any.whl (191.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: fp_agent-0.1.13.tar.gz
  • Upload date:
  • Size: 169.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.13.tar.gz
Algorithm Hash digest
SHA256 c1ce02ff2abc230bc95b415d05d059b756b8c246e4d0c898f40ae7e62a0eed03
MD5 3c48bbb1736a48867bb0316f8d67484d
BLAKE2b-256 4822077efb5c624a7ba3c7c14317236ca6a65a9d5ca1833322e7ef984efa1cdb

See more details on using hashes here.

Provenance

The following attestation bundles were made for fp_agent-0.1.13.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.13-py3-none-any.whl.

File metadata

  • Download URL: fp_agent-0.1.13-py3-none-any.whl
  • Upload date:
  • Size: 191.8 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.13-py3-none-any.whl
Algorithm Hash digest
SHA256 df202dfab2f66c1505b30e4da68bfe8b91439fff950ecfe5ef7ade31397442bb
MD5 de0a8da5a7960754c786ef95cd807d2f
BLAKE2b-256 b1e632e8a3ac943e073a73a3927ebf6a1fcc12cdf39bcf5f0b218d50de42bf89

See more details on using hashes here.

Provenance

The following attestation bundles were made for fp_agent-0.1.13-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

This release

0.1.13 This release

2 files

0.1.12

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