Hermes Agent首个AI应用需四步完成：初始化项目结构、定义YAML技能、启动交互会话、启用持久化记忆，最后可打包为独立CLI应用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功安装Hermes Agent并完成基础配置，但尚未启动首个可运行的AI应用，则可能是由于缺少明确的应用初始化流程或未绑定具体任务上下文。以下是构建您的第一个Hermes AI应用的步骤：
一、初始化项目结构
创建标准化项目目录有助于隔离配置、技能与记忆数据，避免与全局环境产生冲突，并支持后续多应用并行管理。
1、在终端中新建项目文件夹：mkdir my-first-hermes-app && cd my-first-hermes-app
2、初始化空的配置与技能目录：mkdir -p skills config memory
3、生成本地专用的环境变量文件：cp ~/.hermes/.env ./config/.env.local
4、编辑该文件，将所有API密钥字段值替换为占位符（如LLM_API_KEY=sk-xxx改为LLM_API_KEY=YOUR_STEP_API_KEY），保留原始格式与换行。
二、定义首个可执行技能
技能（Skill）是Hermes中封装任务逻辑的基本单元，必须以YAML格式声明输入、输出及执行命令，且需存入skills/目录下才能被自动加载。
1、创建技能文件：nano skills/greet_user.yaml
2、写入以下内容（严格保持缩进与冒号后空格）：
name: greet_user
description: 向用户发送个性化欢迎消息
input_schema:
user_name: {type: string, required: true}
output_schema:
message: {type: string}
command: echo "Hello, {{ user_name }}! This is your first Hermes skill."
3、保存退出后，验证语法是否合法：hermes skill validate greet_user
4、若返回✅ Valid skill definition，则表示技能已就绪。
三、启动交互式AI应用会话
Hermes提供hermes chat命令作为轻量级应用入口，它会自动加载当前目录下的skills/、config/.env.local及memory/中的上下文，形成独立运行沙盒。
1、确保当前工作目录为my-first-hermes-app：pwd
2、启动会话：hermes chat --no-persist
3、在提示符后输入指令：run greet_user with user_name="Alice"
4、观察终端输出是否返回Hello, Alice! This is your first Hermes skill.，确认技能被正确调用与执行。
四、持久化用户偏好与执行历史
启用持久化机制可使Hermes在多次会话间保留用户画像与技能优化记录，这是实现“自我进化”的前提条件。
1、在项目根目录创建记忆文件：touch memory/user.md memory/memory.md
2、向memory/user.md写入初始画像：echo "- name: Alice\n- preferred_language: zh-CN\n- common_tasks: [greet_user]" > memory/user.md
3、启动带持久化功能的会话：hermes chat --persist-memory
4、再次执行run greet_user with user_name="Alice"，随后输入show memory，确认输出中包含preferred_language: zh-CN字段。
五、导出为可分发的CLI应用
将当前项目打包为独立命令行工具，允许他人在无全局Hermes安装环境下直接运行，依赖由Hermes内部uv虚拟环境自动解析。
1、生成应用描述文件：echo '{"name":"my-greeter","entrypoint":"skills/greet_user.yaml","default_input":{"user_name":"Guest"}}' > app.json
2、构建可执行包：hermes app build --output ./dist/my-greeter
3、赋予执行权限：chmod +x ./dist/my-greeter
4、运行打包后的应用：./dist/my-greeter --user_name="Bob"
