能力标签
🛠
AI工具

Syne AI工作流框架

基于 Python · 开源 AI 工具,GitHub 社区精选
英文名:syne
⭐ 13 Stars 🍴 4 Forks 💻 Python 📄 NOASSERTION 🏷 AI 7.0分
7.0AI 综合评分
AI Agent工作流引擎记忆管理LLM框架PostgreSQL
✦ AI Skill Hub 推荐

Syne AI工作流框架 是 AI Skill Hub 本期精选AI工具之一。综合评分 7.0 分,整体质量较高。我们推荐使用将其纳入你的 AI 工具库,帮助提升工作效率。

📚 深度解析
Syne AI工作流框架 是一款基于 Python 的开源工具,在 GitHub 上收获 0k+ Star,是AI Agent、工作流引擎、记忆管理、LLM框架领域中的优质开源项目。开源工具的最大优势在于代码完全透明,你可以审计每一行代码的安全性,也可以根据自身需求进行二次开发和定制。

**为什么要使用开源工具而非商业 SaaS?**
对于个人开发者和有隐私需求的用户,本地部署的开源工具意味着数据不离本机,不受第三方服务商的数据政策约束。同时,开源工具通常没有使用次数限制和月度费用,一次安装即可长期使用,对于高频使用场景的总拥有成本(TCO)远低于订阅制商业工具。

**安装与环境准备**
Syne AI工作流框架 依赖 Python 运行环境。建议通过 pyenv(Python)或 nvm(Node.js)管理 Python 版本,避免全局环境污染。对于新手用户,推荐先创建虚拟环境(python -m venv venv && source venv/bin/activate),再安装依赖,这样即使出现问题也可以随时删除虚拟环境重新开始,不影响系统稳定性。

**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues(已关闭的问题),大多数常见问题都已有解答。遇到 Bug 时,提供 pip list 的输出、完整错误堆栈和最小可复现示例,能显著提高开发者响应速度。AI Skill Hub 将持续追踪 Syne AI工作流框架 的版本更新,及时通知重要功能变化。
📋 工具概览

Syne AI工作流框架 是一款基于 Python 开发的开源工具,专注于 AI Agent、工作流引擎、记忆管理 等核心功能。作为 GitHub 开源项目,它拥有活跃的社区支持和持续的版本迭代,代码完全透明可审计,支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流,都能提供稳定可靠的解决方案。

GitHub Stars
⭐ 13
开发语言
Python
支持平台
Windows / macOS / Linux
维护状态
轻量级项目,按需更新
开源协议
NOASSERTION
AI 综合评分
7.0 分
工具类型
AI工具
Forks
4
📖 中文文档
以下内容由 AI Skill Hub 根据项目信息自动整理,如需查看完整原始文档请访问底部「原始来源」。

Syne AI工作流框架 是一款基于 Python 开发的开源工具,专注于 AI Agent、工作流引擎、记忆管理 等核心功能。作为 GitHub 开源项目,它拥有活跃的社区支持和持续的版本迭代,代码完全透明可审计,支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流,都能提供稳定可靠的解决方案。

📌 核心特色
  • 开源免费,支持本地部署,数据完全自主可控
  • 活跃的 GitHub 开源社区,持续迭代更新
  • 提供详细文档和使用示例,新手友好
  • 支持自定义配置,灵活适配不同使用环境
  • 可作为基础组件集成进现有技术栈或进行二次开发
🎯 主要使用场景
  • 本地部署运行,保护数据隐私,满足合规要求
  • 自定义集成到现有系统,扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发
以下安装命令基于项目开发语言和类型自动生成,实际以官方 README 为准。
安装命令
# 方式一:pip 安装(推荐)
pip install syne

# 方式二:虚拟环境安装(推荐生产环境)
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install syne

# 方式三:从源码安装(获取最新功能)
git clone https://github.com/riyogarta/syne
cd syne
pip install -e .

# 验证安装
python -c "import syne; print('安装成功')"
📋 安装步骤说明
  1. 访问 GitHub 仓库页面
  2. 按照 README 文档完成依赖安装
  3. 根据系统环境完成初始化配置
  4. 参考官方示例或文档开始使用
  5. 遇到问题可在 GitHub Issues 中查找解答
以下用法示例由 AI Skill Hub 整理,涵盖最常见的使用场景。
常用命令 / 代码示例
# 命令行使用
syne --help

# 基本用法
syne input_file -o output_file

# Python 代码中调用
import syne

# 示例
result = syne.process("input")
print(result)
以下配置示例基于典型使用场景生成,具体参数请参照官方文档调整。
配置示例
# syne 配置文件示例(config.yml)
app:
  name: "syne"
  debug: false
  log_level: "INFO"

# 运行时指定配置文件
syne --config config.yml

# 或通过环境变量配置
export SYNE_API_KEY="your-key"
export SYNE_OUTPUT_DIR="./output"
📑 README 深度解析 真实文档 完整度 87/100 查看 GitHub 原文 →
以下内容由系统直接从 GitHub README 解析整理,保留代码块、表格与列表结构。

Syne 🧠

AI Agent Framework with Unlimited Memory

"I remember, therefore I am"

Named after Mnemosyne, the Greek goddess of memory and mother of the Muses.

Syne is a standalone, open-source AI agent framework built in Python. It features PostgreSQL-native memory with semantic search, an ability-based architecture for extensibility, and self-evolution capabilities where the agent can create new abilities for itself.

---

Bundled Abilities

AbilityPermissionDescriptionRequires
image_gen777Generate images from text (FLUX.1-schnell via Together AI / Imagen via Vertex / DALL-E via OpenAI)API key per provider
image_analysis555Analyze and describe images (Gemini 2.5 Flash default; Vertex / Ollama / OpenAI)Provider-specific (Vertex auto, OpenAI key)
maps555Places, directions, geocodingGoogle Maps API key
pdf770**Read** PDFs (text + vision OCR for scanned/CAD pages) and **create** PDFs from text or URLPyMuPDF, reportlab, beautifulsoup4 (auto-installed)
office770**Create and read** Microsoft Office documents — Word (.docx), Excel (.xlsx), PowerPoint (.pptx)python-docx, openpyxl, python-pptx (auto-installed)
website_screenshot550Capture website screenshotsPlaywright + Chromium (auto-installed)
whatsapp700WhatsApp bridge (send/receive via wacli)wacli binary

Each ability manages its own dependencies via ensure_dependencies() — external binaries and packages are auto-installed when you enable the ability.

Minimum Requirements

RequirementDetails
**CPU**1 vCPU minimum (2+ recommended for Ollama embedding + evaluator)
**OS**Linux (Ubuntu 22.04+, Debian 12+)
**Python**3.11+
**RAM**2 GB minimum (Ollama loads one model at a time, ~1.3 GB per model). 4 GB recommended for smooth operation
**Storage**1 GB base + ~1 GB for Ollama models (embedding + evaluator). ~2.5 GB total recommended
**Docker**Required — PostgreSQL 16 + pgvector runs in Docker
**Network**Outbound HTTPS to: LLM provider (Google/OpenAI/Anthropic), Telegram API, Brave Search (optional). Ollama runs locally — no network needed for embedding and memory evaluation

---

Verify Installation

syne repair     # Diagnose: DB, OAuth, Telegram, abilities
syne status     # Quick status check

---

Setup

On the server (one-time): ```bash

Gateway is built into Syne — no extra setup needed

Setup & Running

syne init # Interactive setup (fully automated) syne start # Start Telegram agent syne start --debug # Start with debug logging syne cli # Interactive CLI chat (resumes per-directory) syne cli -n # Start fresh conversation (clear history) syne cli --yolo # Skip file write approvals (auto-yes) syne status # Show status syne repair # Diagnose and repair syne restart # Restart agent syne stop # Stop agent

🚀 Quick Start — 3 Commands

git clone https://github.com/riyogarta/syne.git
cd syne
bash install.sh

That's it. install.sh is fully automated:

StepWhat happens
Choose AI provider (OAuth free / API key)
Auto-detect hardware → recommend models
Enter Telegram bot token
Docker + PostgreSQL + pgvector
Ollama + embedding + evaluator models
Database schema + systemd service
When install finishes, Syne is running.

Example: allow public to search Al-Quran and Hadith memories

Set config memory.public_categories to ["alquran","bukhari","muslim","fiqih"] ```

RequesterAllowed categoriesRule
**Owner**All760
**Family**All760
**Public**Only categories in memory.public_categories765

When a public user searches memories, results outside the allowed categories are silently filtered — they appear as if they don't exist.

No Runtime Config Files — Just Talk

Most agent frameworks require editing SOUL.md, AGENTS.md, or CONFIG.yaml to change behavior. Syne has none of that — all runtime behavior lives in PostgreSQL, and you change it through conversation:

Traditional FileSyne EquivalentJust say...
SOUL.mdsoul table*"Be more casual and witty"*
AGENTS.mdrules table*"Add a rule: never share my location"*
IDENTITY.mdidentity table*"Change your name to Atlas"*
CONFIG.yamlconfig table*"Turn on auto memory capture"*

Fresh install comes with sensible defaults. Override anything through conversation — no SQL, no files.

---

Configuration Reference

All configuration lives in the config table. Change via conversation or update_config tool.

Provider Settings

KeyDefaultDescription
provider.active_model"gemini-pro"Active chat model key
provider.active_embedding*(set during init)*Active embedding model key (auto-detected by hardware tier)

Memory Settings

KeyDefaultDescription
memory.auto_capturefalseAuto-evaluate messages for storage
memory.recall_limit5Max memories per query
memory.decay_interval50Decay every N conversations
memory.decay_amount1Recall count decrease per decay cycle
memory.initial_recall_count5Starting durability for new memories
memory.promotion_threshold10Promote to permanent when recall_count exceeds this
memory.evaluator_driver"ollama"Evaluator: "ollama" (local) or "provider" (main LLM)
memory.evaluator_model"qwen3:0.6b"Ollama model for evaluation

Session Settings

KeyDefaultDescription
session.compaction_threshold80000Characters before auto-compaction
session.compaction_keep_recent40Messages kept after compaction
session.max_messages100Messages before suggesting compaction
session.thinking_budgetnullGlobal default only — per-model thinking is set via /models

Claude OAuth (Optional)

KeyDefaultDescription
claude.oauth_client_id*(built-in)*Override OAuth client_id for Anthropic Claude

Exec & Web Settings

KeyDefaultDescription
exec.timeout_max300Max exec timeout (seconds)
exec.output_max_chars4000Max output characters
web_fetch.timeout30HTTP fetch timeout (seconds)

Sub-agent Settings

KeyDefaultDescription
subagents.enabledtrueEnable sub-agents
subagents.max_concurrent2Max concurrent sub-agents
subagents.timeout_seconds900Sub-agent timeout (15 min)

---

Node CLI Commands

syne node init           # Pair with server
syne node start          # Start node daemon
syne node stop           # Stop node daemon
syne node restart        # Restart node daemon
syne node status         # Show connection status

---

Ability Interface

class Ability:
    name: str
    description: str
    version: str
    permission: int = 0o700  # 3-digit octal (owner/family/public)

    async def execute(self, params: dict, context: dict) -> dict: ...
    def get_schema(self) -> dict: ...
    def get_guide(self, enabled: bool, config: dict) -> str: ...
    async def ensure_dependencies(self) -> tuple[bool, str]: ...

CLI Commands

```bash

Document Workflows

The pdf and office abilities together cover most document workflows. Both auto-extract content when a user uploads a file via Telegram — the LLM sees the document content as plain text without needing any tool call.

FormatReadCreateNotes
PDFHybrid mode: text + vision OCR for scanned/drawing pages (uses /vision provider)
DOCX (Word)Markdown-style content for create; auto-extracts paragraphs + tables on read
XLSX (Excel)JSON sheets array for create; renders as markdown table on read
PPTX (PowerPoint)JSON slides array for create; extracts per-slide text on read

Examples (LLM-callable):

office(action='create_docx', title='Laporan', content='# Ringkasan\n\nIsi paragraf.')
office(action='create_xlsx', sheets='[{"name":"Q1","headers":["Item","Total"],"rows":[["Gaji",10000]]}]')
office(action='create_pptx', title='Proposal', slides='[{"title":"Slide 1","bullets":["A","B"]}]')
pdf(action='make_from_text', title='Doc', text='...')
pdf(action='read_from_url', url='https://example.com/file.pdf')

---

Auto Capture vs Manual

ModeTriggerCost impact
auto_capture = false (default)Only when user says "remember this"No extra calls
auto_capture = trueEvery message evaluated+1 evaluator call + 1 embedding per message

With Ollama as both evaluator and embedding provider, auto-capture costs $0 — both run locally.

🇨🇳 中文文档镜像 AI 翻译 2026-05-24
英文原文章节由系统翻译为中文摘要,便于快速理解。完整原文见上方 "📑 README 深度解析"。
📌 简介

Syne 是一个开源的 Python AI 代理框架,基于 PostgreSQL 的内存,支持语义搜索,具有可扩展的能力架构和自我演化能力。它以希腊神话中的记忆女神 Mnemosyne 命名。

⚡ 功能介绍

Syne 支持多种能力,包括图像生成和分析,用户可以选择不同的 AI 提供商和模型。它还支持自定义能力和扩展性。

📋 环境依赖

Syne 的最低要求包括 1 个 CPU、2 GB 的 RAM、Linux 操作系统(Ubuntu 22.04+ 或 Debian 12+)和 Python 3.11+。

🛠 安装步骤(Docker/pip/源码)

Syne 的安装过程包括选择 AI 提供商、自动检测硬件并推荐模型、输入 Telegram 机器人令牌、安装 Docker 和 PostgreSQL、加载 Ollama 模型和数据库等步骤。

🚀 使用教程

Syne 的使用教程包括快速启动、配置和 API 接口等方面。用户可以通过命令行工具和 Telegram 机器人与 Syne 进行交互。

⚙️ 配置说明(含 MCP / env)

Syne 的配置是通过 PostgreSQL 中的表格来实现的,用户可以通过命令行工具和 Telegram 机器人来修改配置。配置包括 AI 提供商、模型和权限等方面。

🔌 API 说明

Syne 提供了 Node CLI 命令和能力接口,用户可以通过这些接口来与 Syne 进行交互。

🔄 工作流/模块

Syne 支持多种工作流和模块,包括 PDF 和 Office 文档的自动提取内容和创建等功能。

🎯 aiskill88 AI 点评 B 级 2026-05-23

aiskill88点评:独特的PostgreSQL原生记忆设计和自演进能力很有创意,但项目成熟度需提升,适合早期探索者。

📚 实用指南(长尾问题)
适合谁
  • 构建多智能体协作系统的 Agent 开发者
  • 构建企业知识库 / RAG 检索应用的团队
  • 需要从图片、PDF 提取文字的文档自动化场景
  • 做语音类 AI 产品的开发者
最佳实践
  • 生产部署优先使用 Docker Compose 隔离依赖,并挂载 volume 持久化数据
  • 本地部署优先选 GGUF 量化模型,节省显存并保持响应速度
  • Agent 任务先做 dry-run 验证工具调用链,再开启自主执行
常见错误
  • API key 直接提交到 git 仓库(请用 .env 并加入 .gitignore)
  • 容器内无法访问宿主机 localhost — 使用 host.docker.internal
  • 显存不足直接 OOM — 优先降低 context 或换更小的量化模型
  • Python 依赖冲突:建议用 venv / uv 隔离环境
部署方案
  • Docker:syne 提供官方镜像,docker compose up 一键启动
  • CLI:直接 npm install -g / pip install,命令行调用
  • 本地部署:CPU 8GB 起,GPU 推荐 16GB+ 显存
  • 云端托管:可放在 Vercel / Railway / Fly.io 等 PaaS 平台
相关搜索
syne 中文教程syne 安装报错怎么办syne Docker 部署syne Agent 工作流syne 与同类工具对比syne 最佳实践syne 适合谁用
⚡ 核心功能
👥 适合谁
  • 构建多智能体协作系统的 Agent 开发者
  • 构建企业知识库 / RAG 检索应用的团队
  • 需要从图片、PDF 提取文字的文档自动化场景
  • 做语音类 AI 产品的开发者
⭐ 最佳实践
  • 生产部署优先使用 Docker Compose 隔离依赖,并挂载 volume 持久化数据
  • 本地部署优先选 GGUF 量化模型,节省显存并保持响应速度
  • Agent 任务先做 dry-run 验证工具调用链,再开启自主执行
⚠️ 常见错误
  • API key 直接提交到 git 仓库(请用 .env 并加入 .gitignore)
  • 容器内无法访问宿主机 localhost — 使用 host.docker.internal
  • 显存不足直接 OOM — 优先降低 context 或换更小的量化模型
  • Python 依赖冲突:建议用 venv / uv 隔离环境
👥 适合人群
AI 技术爱好者研究人员和学生开发者和工程师技术创业者
🎯 使用场景
  • 本地部署运行,保护数据隐私,满足合规要求
  • 自定义集成到现有系统,扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发
⚖️ 优点与不足
✅ 优点
  • +完全开源免费,无授权费用
  • +本地部署,数据完全自主可控
  • +开发者社区支持,遇问题可查可问
⚠️ 不足
  • 安装和初始配置可能需要一定技术基础
  • 功能完整性通常不如成熟商业产品
  • 技术支持主要依赖开源社区,响应速度不稳定
⚠️ 使用须知

该工具使用 NOASSERTION 协议,商用场景请仔细阅读协议条款,必要时咨询法律意见。

AI Skill Hub 为第三方内容聚合平台,本页面信息基于公开数据整理,不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后,再部署至生产环境,并做好必要的安全评估。

📄 License 说明

📄 NOASSERTION — 请查阅原始协议条款了解具体使用限制。

🔗 相关工具推荐
📚 相关教程推荐
📰 相关 AI 新闻
🍿 AI 圈相关吃瓜
🗺️ 相关解决方案
🧩 你可能还需要
基于当前 Skill 的能力图谱,自动补全的工具组合
❓ 常见问题 FAQ
支持Gemini等多种LLM接口,可通过插件扩展其他模型
💡 AI Skill Hub 点评

经综合评估,Syne AI工作流框架 在AI工具赛道中表现稳健,质量良好。如果你已有明确的使用需求,可以直接上手体验;如果还在评估阶段,建议对比同类工具后再做决策。

📚 深入学习 Syne AI工作流框架
查看分步骤安装教程和完整使用指南,快速上手这款工具
🌐 原始信息
原始名称 syne
原始描述 开源AI工作流:AI Agent Framework with Unlimited Memory — PostgreSQL-native, self-evolving, nea。⭐13 · Python
Topics AI Agent工作流引擎记忆管理LLM框架PostgreSQL
GitHub https://github.com/riyogarta/syne
License NOASSERTION
语言 Python
🔗 原始来源
🐙 GitHub 仓库  https://github.com/riyogarta/syne

收录时间:2026-05-22 · 更新时间:2026-05-26 · License:NOASSERTION · AI Skill Hub 不对第三方内容的准确性作法律背书。