OrgKernel部署指南PostgreSQL/MySQL/SQLite三大数据库任选10分钟完成安装配置【免费下载链接】OrgKernelOpen-source trust layer for AI agents — cryptographic agent identity (Ed25519), instance-scoped execution tokens, SHA-256 hash-chained audit logging, and enterprise SSO/SCIM federation. The security foundation powering every agent in the Metaprise AURA platform.项目地址: https://gitcode.com/gh_mirrors/or/OrgKernelOrgKernel 是一款面向 AI Agent 的开源信任层Trust Layer项目提供 Ed25519 加密身份、实例级执行令牌和 SHA-256 哈希链审计日志能力。OrgKernel 部署过程非常轻量只需 Python 3.10 环境配合 PostgreSQL、MySQL 或 SQLite 中任意一种数据库即可在 10 分钟内完成安装与配置。本指南面向新手用户带你从零开始走完 OrgKernel 部署全流程——选择数据库、执行安装、配置连接、验证启动每一步都有清晰的操作说明不需要任何加密学背景知识 一、部署前准备环境要求一览OrgKernel 基于 Python 异步框架构建部署前请确认你的机器满足以下条件依赖项版本要求说明Python3.10推荐 3.12核心运行时环境数据库PostgreSQL / MySQL / SQLite 三选一持久化存储层Git任意较新版本用于获取源码核心依赖pydantic、sqlalchemy、cryptography、fastapi会在安装时自动处理无需手动操心。新手建议本地学习、功能验证阶段用 SQLite 最省心——零安装、单文件、开箱即用。生产环境则推荐 PostgreSQL官方也将其作为推荐方案。二、三大数据库怎么选一张表看懂OrgKernel 通过 SQLAlchemy 异步引擎支持三种数据库你在 pyproject.toml 中可以看到对应的数据库驱动扩展包定义。不同场景的推荐选择如下数据库安装扩展包适用场景特点PostgreSQL ⭐推荐orgkernel[postgres]生产环境性能稳定、功能完整官方首选MySQL / MariaDBorgkernel[mysql]已有 MySQL 基础设施的团队生态成熟需使用 InnoDB 引擎SQLiteorgkernel[sqlite]本地开发、快速上手免安装、零配置一个文件搞定如果你还想同时体验三种数据库也可以安装全家桶pip install orgkernel[all-db]。 选哪个不确定记住这条原则开发用 SQLite上线用 PostgreSQL绝大多数情况下不会错。三、安装步骤3 条命令完成 OrgKernel 部署第 1 步获取源码git clone https://gitcode.com/gh_mirrors/or/OrgKernel cd OrgKernel第 2 步创建虚拟环境推荐python -m venv .venv # Linux / macOS source .venv/bin/activate # Windows .venv\Scripts\activate第 3 步选择数据库并安装根据你的数据库选择执行对应命令# PostgreSQL推荐 pip install -e .[postgres] # MySQL / MariaDB pip install -e .[mysql] # SQLite本地开发 pip install -e .[sqlite]✅ 安装完成后运行python -c import orgkernel若无报错即说明安装成功。到这里OrgKernel 部署的核心步骤已经全部完成——剩下的只是告诉程序数据库在哪里。四、配置数据库连接3 种连接串一次写对OrgKernel 的数据库接入逻辑集中在 database.py 中。整个连接配置只需设置一行 URL三种数据库的写法如下数据库连接串格式PostgreSQLpostgresqlasyncpg://用户:密码主机:5432/orgkernelMySQLmysqlaiomysql://用户:密码主机:3306/orgkernelSQLitesqliteaiosqlite:///./orgkernel.db其中 SQLite 的写法最简单——./orgkernel.db表示在当前目录生成一个数据库文件首次运行自动创建无需提前建库。⚠️两个容易踩的坑PostgreSQL 用户首次运行前请执行CREATE EXTENSION IF NOT EXISTS pgcrypto;用于启用 SHA-256 哈希函数审计链完整性校验依赖它MySQL 用户请确认目标库使用InnoDB存储引擎以保证事务支持。五、启动与验证1 分钟跑通冒烟测试设置好连接串后OrgKernel 会在启动时自动建表。程序启动的固定动作是两步from orgkernel.database import async_engine, init_db async_engine.url sqliteaiosqlite:///./orgkernel.db # 换成你的连接串 await init_db()init_db() 会扫描 models.py 中定义的全部数据表并自动创建包括 4 张核心表sys_orgkernel_agent_identity— Agent 加密身份记录sys_orgkernel_execution_token— 执行令牌记录sys_orgkernel_audit_chain— 审计链头信息sys_orgkernel_audit_entry— 审计条目明细如何验证部署成功数据库层面连接你的数据库查看上述 4 张sys_orgkernel_开头的表是否已创建API 层面将 OrgKernel 的 router 挂载到 FastAPI 应用后访问/orgkernel/identity/org/{org_id}等端点能返回正常响应即代表服务就绪。如果想在 10 分钟内完成一次端到端体验直接选 SQLite 上面的启动代码全程不超过 5 分钟 ⚡六、常见问题 FAQQ1安装时报缺少数据库驱动确认你安装的扩展包与实际数据库匹配PostgreSQL 用[postgres]、MySQL 用[mysql]、SQLite 用[sqlite]三者不能混用。Q2启动时提示 No engine set说明调用init_db()之前没有设置连接串。请先执行async_engine.url 你的连接串参考 database.py 中的全局引擎说明。Q3SQLite 文件放在哪路径由连接串决定sqliteaiosqlite:///./orgkernel.db表示应用运行目录下的orgkernel.db。建议不要放在会被清理的临时目录中。Q4可以中途更换数据库类型吗技术上只需更换连接串和驱动包即可但不同数据库的 SQL 方言有差异建议开发环境与生产环境保持一致避免行为偏差。Q5生产环境的安全注意事项连接串中的账号密码请使用环境变量管理不要硬编码进代码PostgreSQL 生产环境建议额外为审计表做好备份策略毕竟审计链是合规追溯的核心依据 七、总结回顾一下 OrgKernel 部署的完整路径只需 4 步选数据库——开发选 SQLite生产选 PostgreSQL装依赖——pip install -e .[对应扩展]一条命令配连接——一行 URL 搞定跑验证——init_db()自动建表查询 4 张sys_orgkernel_表确认就绪。整个过程不到 10 分钟你就拥有了一个支持加密身份、执行令牌与防篡改审计链的 AI Agent 信任基础设施。下一步可以继续阅读项目文档了解 REST API 的 27 个端点用法把 OrgKernel 真正接入你的 Agent 平台 【免费下载链接】OrgKernelOpen-source trust layer for AI agents — cryptographic agent identity (Ed25519), instance-scoped execution tokens, SHA-256 hash-chained audit logging, and enterprise SSO/SCIM federation. The security foundation powering every agent in the Metaprise AURA platform.项目地址: https://gitcode.com/gh_mirrors/or/OrgKernel创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考