vault backup: 2026-05-18 19:41:01
This commit is contained in:
parent
1480da7e44
commit
fe3278e7ab
23 changed files with 589 additions and 19 deletions
|
|
@ -1,7 +1,23 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: Developer_Manual
|
||||
status: active
|
||||
tags:
|
||||
- client/oliver
|
||||
- tech/azure-ad
|
||||
- tech/claude
|
||||
- tech/docker
|
||||
- tech/nextjs
|
||||
- tech/ollama
|
||||
- tech/pgvector
|
||||
- tech/postgresql
|
||||
- tech/react
|
||||
- tech/tailwind
|
||||
- tech/typescript
|
||||
type: project
|
||||
---
|
||||
|
||||
# HP CG Production Tracker - Developer Manual
|
||||
|
|
@ -169,4 +185,9 @@ The `docker-compose.yml` defines:
|
|||
2. **AI Fallback:** If `ANTHROPIC_API_KEY` is not set, the app falls back to Ollama. Ensure Ollama is running and the model `gemma4` or `qwen3` is pulled.
|
||||
3. **PKCE Flow:** Since this is an SPA, do not use `AZURE_CLIENT_SECRET`. Ensure the Azure App Registration is set up as a "Single Page Application" with PKCE.
|
||||
4. **Vector Search:** Ensure `pgvector` is enabled in PostgreSQL. The Docker volume `./docker/db-init.sql` handles this, but verify it runs on DB restart.
|
||||
5. **File Uploads:** Media uploads are stored in `uploads_data` volume. Ensure the Docker user has write permissions to `/data/uploads`.
|
||||
5. **File Uploads:** Media uploads are stored in `uploads_data` volume. Ensure the Docker user has write permissions to `/data/uploads`.
|
||||
|
||||
## Related
|
||||
- [[01 Projects/ppt-tool/DEVELOPER_MANUAL.md]]
|
||||
- [[01 Projects/olivas/DEVELOPER_MANUAL.md]]
|
||||
- [[01 Projects/Oliver-ai-bot_2.0/DEVELOPER_MANUAL.md]]
|
||||
|
|
@ -1,7 +1,19 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: User_Manual
|
||||
status: active
|
||||
tags:
|
||||
- domain/analytics
|
||||
- tech/azure-ad
|
||||
- tech/claude
|
||||
- tech/node
|
||||
- tech/react
|
||||
- tech/typescript
|
||||
- type/sop
|
||||
type: sop
|
||||
---
|
||||
|
||||
# HP CG Production Tracker - User Manual
|
||||
|
|
@ -109,4 +121,7 @@ A: Ensure you have selected the correct project context. If no projects are visi
|
|||
A: Yes. The application supports video uploads processed by FFmpeg. You can view previews via HLS.js in the deliverable details.
|
||||
|
||||
**Q: Is the AI assistant free?**
|
||||
A: The AI assistant uses local inference via Ollama for embeddings and fallbacks, and Claude API for primary queries. Availability depends on server configuration and API limits set by the admin.
|
||||
A: The AI assistant uses local inference via Ollama for embeddings and fallbacks, and Claude API for primary queries. Availability depends on server configuration and API limits set by the admin.
|
||||
|
||||
## Related
|
||||
- [[01 Projects/cc-dashboard/USER_MANUAL.md]]
|
||||
|
|
@ -1,7 +1,20 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: Developer_Manual
|
||||
status: active
|
||||
tags:
|
||||
- client/loreal
|
||||
- domain/analytics
|
||||
- domain/security
|
||||
- tech/azure-ad
|
||||
- tech/docker
|
||||
- tech/node
|
||||
- tech/postgresql
|
||||
- type/sop
|
||||
type: sop
|
||||
---
|
||||
|
||||
# L'Oréal SLA Calculator Developer Manual
|
||||
|
|
@ -95,4 +108,7 @@ The application is a hybrid architecture:
|
|||
- **Auth Bypass**: Authentication is explicitly bypassed on `localhost` and `127.0.0.1` for development convenience.
|
||||
- **Token Refresh**: The frontend attempts one silent token refresh on 401 errors before logging the user out.
|
||||
- **Config Caching**: Browsers may aggressively cache `config.json`. Use the timestamp query string (`?v=...`) to force updates during development.
|
||||
- **Password Encoding**: Passwords are Base64 encoded before transmission in the legacy email/password flow to avoid WAF issues with special characters.
|
||||
- **Password Encoding**: Passwords are Base64 encoded before transmission in the legacy email/password flow to avoid WAF issues with special characters.
|
||||
|
||||
## Related
|
||||
- [[01 Projects/olivas/DEVELOPER_MANUAL.md]]
|
||||
|
|
@ -1,7 +1,18 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: User_Manual
|
||||
status: active
|
||||
tags:
|
||||
- client/loreal
|
||||
- status/active
|
||||
- tech/nextjs
|
||||
- tech/python
|
||||
- tech/react
|
||||
- type/sop
|
||||
type: sop
|
||||
---
|
||||
|
||||
# L'Oréal SLA Calculator User Manual
|
||||
|
|
@ -59,4 +70,7 @@ A: Yes, revision rounds can be set with decimal precision in the PM Calculator c
|
|||
A: Non-developers can update assumptions, stage definitions, and default values by editing the `config.json` file directly.
|
||||
|
||||
**Q: What happens if the deadline cannot be met?**
|
||||
A: The tool provides a "No" verdict and allows you to adjust inputs (like complexity or revisions) to see how changes impact the timeline.
|
||||
A: The tool provides a "No" verdict and allows you to adjust inputs (like complexity or revisions) to see how changes impact the timeline.
|
||||
|
||||
## Related
|
||||
- [[01 Projects/lusa-back-planner/USER_MANUAL.md]]
|
||||
|
|
@ -1,7 +1,16 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: Developer_Manual
|
||||
status: active
|
||||
tags:
|
||||
- client/loreal
|
||||
- domain/devops
|
||||
- tech/react
|
||||
- type/reference
|
||||
type: reference
|
||||
---
|
||||
|
||||
# Loreal Timelog Viewer Developer Manual
|
||||
|
|
|
|||
|
|
@ -1,7 +1,16 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: User_Manual
|
||||
status: active
|
||||
tags:
|
||||
- client/loreal
|
||||
- domain/analytics
|
||||
- status/active
|
||||
- type/sop
|
||||
type: sop
|
||||
---
|
||||
|
||||
# Loreal Timelog Viewer User Manual
|
||||
|
|
|
|||
|
|
@ -1,7 +1,17 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: Developer_Manual
|
||||
status: active
|
||||
tags:
|
||||
- domain/devops
|
||||
- tech/docker
|
||||
- tech/hatchling
|
||||
- tech/python
|
||||
- type/sop
|
||||
type: sop
|
||||
---
|
||||
|
||||
# MD to Word Converter Developer Manual
|
||||
|
|
@ -115,4 +125,4 @@ A Dockerfile can be created to containerize the application. Ensure system depen
|
|||
- **Font Loading**: Mermaid CSS loads Montserrat from Google Fonts. In offline environments, provide a local font file or use a different font family.
|
||||
- **Temporary Files**: The tool creates temp files for Mermaid rendering. These are not cleaned up automatically in all cases.
|
||||
- **Python Version**: Requires Python 3.9+. Do not use with Python <3.9 due to dependency compatibility.
|
||||
- **Large Documents**: Performance may degrade with very large Markdown files due to repeated temp file creation and Mermaid rendering.
|
||||
- **Large Documents**: Performance may degrade with very large Markdown files due to repeated temp file creation and Mermaid rendering.
|
||||
|
|
@ -1,7 +1,16 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: User_Manual
|
||||
status: active
|
||||
tags:
|
||||
- domain/devops
|
||||
- tech/markdown
|
||||
- tech/python
|
||||
- type/sop
|
||||
type: sop
|
||||
---
|
||||
|
||||
# MD to Word Converter User Manual
|
||||
|
|
@ -97,3 +106,7 @@ A: The current CLI supports one input file per run. Use shell loops or scripts t
|
|||
|
||||
**Q: What happens if a Mermaid diagram has syntax errors?**
|
||||
A: The renderer may fail silently or produce broken images. Check your Mermaid syntax carefully before conversion.
|
||||
|
||||
## Related
|
||||
- [[01 Projects/md to word/DEVELOPER_MANUAL.md]]
|
||||
- [[Mermaid CLI Installation]]
|
||||
|
|
@ -1,7 +1,30 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: Developer_Manual
|
||||
status: active
|
||||
tags:
|
||||
- domain/ai
|
||||
- domain/security
|
||||
- tech/azure-ad
|
||||
- tech/docker
|
||||
- tech/express
|
||||
- tech/gemini
|
||||
- tech/jwt
|
||||
- tech/mongodb
|
||||
- tech/msal
|
||||
- tech/node
|
||||
- tech/react
|
||||
- tech/reactive
|
||||
- tech/socket-io
|
||||
- tech/socket.io-client
|
||||
- tech/sonner
|
||||
- tech/tanstack-query
|
||||
- tech/typescript
|
||||
- type/sop
|
||||
type: sop
|
||||
---
|
||||
|
||||
# Semblance Synthetic Society — Developer Manual
|
||||
|
|
@ -177,4 +200,7 @@ Semblance is a full-stack web application with a React frontend and a Node.js ba
|
|||
The `parseMentions` function uses a specific regex for `@mentions`. Be aware that complex names with special characters or punctuation may not be parsed correctly. The regex stops at conjunctions (`and`, `or`) and non-word boundaries.
|
||||
|
||||
5. **Port Binding:**
|
||||
Backend and MongoDB are bound to `127.0.0.1` in `docker-compose.yml`. This ensures they are not exposed to the public internet, but requires port forwarding or a reverse proxy for remote access.
|
||||
Backend and MongoDB are bound to `127.0.0.1` in `docker-compose.yml`. This ensures they are not exposed to the public internet, but requires port forwarding or a reverse proxy for remote access.
|
||||
|
||||
## Related
|
||||
- [[01 Projects/sandbox-notebookllamalm-nextjs/DEVELOPER_MANUAL.md]]
|
||||
|
|
@ -1,7 +1,17 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: User_Manual
|
||||
status: active
|
||||
tags:
|
||||
- domain/ai
|
||||
- tech/azure-ad
|
||||
- tech/gemini
|
||||
- tech/typescript
|
||||
- type/sop
|
||||
type: sop
|
||||
---
|
||||
|
||||
# Semblance Synthetic Society — User Manual
|
||||
|
|
@ -97,4 +107,8 @@ A: Yes. Even in Autonomous Mode, if you have moderator privileges, you can type
|
|||
A: Persona data, session transcripts, and analytics are stored in the MongoDB database. Ensure you comply with your organization's data privacy policies when creating personas.
|
||||
|
||||
**Q: How do I export session insights?**
|
||||
A: Session summaries and theme extractions are available post-session. You can often export these as reports or view them in the analytics dashboard.
|
||||
A: Session summaries and theme extractions are available post-session. You can often export these as reports or view them in the analytics dashboard.
|
||||
|
||||
## Related
|
||||
- [[02 Areas/Market Research Processes]]
|
||||
- [[03 Resources/AI Persona Design Guide]]
|
||||
|
|
@ -1,7 +1,26 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: Developer_Manual
|
||||
status: active
|
||||
tags:
|
||||
- client/oliver
|
||||
- domain/accessibility
|
||||
- domain/ai
|
||||
- tech/azure-ad
|
||||
- tech/celery
|
||||
- tech/docker
|
||||
- tech/fastapi
|
||||
- tech/gemini
|
||||
- tech/mongodb
|
||||
- tech/python
|
||||
- tech/react
|
||||
- tech/redis
|
||||
- tech/typescript
|
||||
- type/sop
|
||||
type: sop
|
||||
---
|
||||
|
||||
# Developer Manual: Accessible Video Processing Platform
|
||||
|
|
@ -173,4 +192,9 @@ celery -A celery_app worker -Q whisper -c 1
|
|||
2. **TTS Quotas**: Google Cloud TTS and ElevenLabs have rate limits. Monitor usage and implement backoff strategies in the TTS worker.
|
||||
3. **WebSocket Reconnects**: The frontend handles auto-reconnects. Ensure the backend WebSocket server is stable; unexpected disconnections may require a manual page refresh if reconnect fails.
|
||||
4. **Signed URLs**: Generated download links expire after 24 hours. If a user tries to download later, they must re-request the link from the API.
|
||||
5. **MSAL Config**: Ensure `msalConfig.ts` matches the Azure AD redirect URIs exactly, including the `basename` (`/video-accessibility`) if deployed to a sub-path.
|
||||
5. **MSAL Config**: Ensure `msalConfig.ts` matches the Azure AD redirect URIs exactly, including the `basename` (`/video-accessibility`) if deployed to a sub-path.
|
||||
|
||||
## Related
|
||||
- [[01 Projects/oliver-ai-assistant/DEVELOPER_MANUAL.md]]
|
||||
- [[01 Projects/ppt-tool/DEVELOPER_MANUAL.md]]
|
||||
- [[01 Projects/ac-helper/DEVELOPER_MANUAL.md]]
|
||||
|
|
@ -1,7 +1,18 @@
|
|||
---
|
||||
auto_generated: true
|
||||
created: 2026-05-18
|
||||
manual_updated_at: 2026-05-18
|
||||
modified: 2026-05-18
|
||||
name: User_Manual
|
||||
status: active
|
||||
tags:
|
||||
- domain/accessibility
|
||||
- domain/ai
|
||||
- tech/docker
|
||||
- tech/gemini
|
||||
- tech/react
|
||||
- type/sop
|
||||
type: sop
|
||||
---
|
||||
|
||||
# User Manual: Accessible Video Processing Platform
|
||||
|
|
@ -104,4 +115,7 @@ A: Check the **Job Detail** logs. If it remains stuck for more than 10 minutes,
|
|||
A: Files are stored in Google Cloud Storage with signed URLs that expire after 24 hours. The platform also enforces strict Role-Based Access Control (RBAC).
|
||||
|
||||
**Q: Who can approve my work?**
|
||||
A: Only users with the **Reviewer** or **Admin** role can approve jobs. Clients cannot self-approve their own submissions.
|
||||
A: Only users with the **Reviewer** or **Admin** role can approve jobs. Clients cannot self-approve their own submissions.
|
||||
|
||||
## Related
|
||||
- [[01 Projects/video-accessibility-old/DEVELOPER_MANUAL.md]]
|
||||
|
|
@ -1,17 +1,41 @@
|
|||
---
|
||||
name: "Shumiland"
|
||||
client: Aimpress LTD
|
||||
status: active
|
||||
server: aimpress
|
||||
tech: [Next.js 16, Payload CMS 3, PostgreSQL 16, Docker, Traefik]
|
||||
local_path: /Users/ai_leed/Documents/Projects/Shumiland
|
||||
repo: https://git.ai-impress.com/Aimpress/Shumiland.git # Forgejo
|
||||
deploy: "ssh aimpress → /opt/03-business/shumiland → git pull + docker compose build + up"
|
||||
url: https://shumi.ai-impress.com
|
||||
tags: [shumiland, nextjs, payload-cms, docker, ukraine, children-park]
|
||||
created: 2026-05-13
|
||||
deploy: ssh aimpress → /opt/03-business/shumiland → git pull + docker compose build
|
||||
+ up
|
||||
last_commit: 2026-05-13
|
||||
local_path: /Users/ai_leed/Documents/Projects/Shumiland
|
||||
modified: 2026-05-18
|
||||
name: Shumiland
|
||||
port: 3000
|
||||
repo: https://git.ai-impress.com/Aimpress/Shumiland.git
|
||||
server: aimpress
|
||||
status: active
|
||||
tags:
|
||||
- children-park
|
||||
- client/aimpress
|
||||
- docker
|
||||
- domain/devops
|
||||
- nextjs
|
||||
- payload-cms
|
||||
- shumiland
|
||||
- tech/docker
|
||||
- tech/nextjs
|
||||
- tech/payload-cms
|
||||
- tech/postgresql
|
||||
- tech/react
|
||||
- tech/tailwind
|
||||
- tech/typescript
|
||||
- type/project
|
||||
- ukraine
|
||||
tech:
|
||||
- Next.js 16
|
||||
- Payload CMS 3
|
||||
- PostgreSQL 16
|
||||
- Docker
|
||||
- Traefik
|
||||
type: project
|
||||
url: https://shumi.ai-impress.com
|
||||
---
|
||||
|
||||
# Shumiland — Сайт дитячого парку
|
||||
|
|
@ -224,3 +248,6 @@ pnpm payload migrate
|
|||
| 2026-05-13 | Nav dropdown hover fix (pt-2 bridge); "Детальніше" button on lokatsii page; dyvolis href fixes |
|
||||
| 2026-05-13 | DyvoLis: "Диво Ліс 250 грн" перший квиток; графік "щодня з 11:00 до 20:00" |
|
||||
| 2026-05-13 | DyvoLis visual overhaul: bg #f1fbeb, 3D coverflow gallery, WhyParents-style section, compact tickets |
|
||||
|
||||
## Related
|
||||
- [[05 Aimpress LTD/Shumiland/Shumiland.md]]
|
||||
1
4a5c465b25cfe73154c51bd2bc8758a6_MD5.svg
Normal file
1
4a5c465b25cfe73154c51bd2bc8758a6_MD5.svg
Normal file
|
|
@ -0,0 +1 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" width="124.5" height="28" role="img" aria-label="LICENSE: MIT"><title>LICENSE: MIT</title><g shape-rendering="crispEdges"><rect width="75.75" height="28" fill="#555"/><rect x="75.75" width="48.75" height="28" fill="#97ca00"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="100"><text transform="scale(.1)" x="378.75" y="175" textLength="517.5" fill="#fff">LICENSE</text><text transform="scale(.1)" x="1001.25" y="175" textLength="247.5" fill="#fff" font-weight="bold">MIT</text></g></svg>
|
||||
|
After Width: | Height: | Size: 619 B |
BIN
799a7f85a6cd2ee30f64fd9d7763519e_MD5.png
Normal file
BIN
799a7f85a6cd2ee30f64fd9d7763519e_MD5.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 12 KiB |
1
8411fb34fe3c1ed62e71648aed13c84b_MD5.svg
Normal file
1
8411fb34fe3c1ed62e71648aed13c84b_MD5.svg
Normal file
|
|
@ -0,0 +1 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" width="215.25" height="28" role="img" aria-label="BUILT BY: NOUS RESEARCH"><title>BUILT BY: NOUS RESEARCH</title><g shape-rendering="crispEdges"><rect width="80" height="28" fill="#555"/><rect x="80" width="135.25" height="28" fill="blueviolet"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="100"><text transform="scale(.1)" x="400" y="175" textLength="560" fill="#fff">BUILT BY</text><text transform="scale(.1)" x="1476.25" y="175" textLength="1112.5" fill="#fff" font-weight="bold">NOUS RESEARCH</text></g></svg>
|
||||
|
After Width: | Height: | Size: 647 B |
1
8a4d52b2d756a11b786a67d977590d8e_MD5.svg
Normal file
1
8a4d52b2d756a11b786a67d977590d8e_MD5.svg
Normal file
|
|
@ -0,0 +1 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" width="102.5" height="28" role="img" aria-label="LANG: 中文"><title>LANG: 中文</title><g shape-rendering="crispEdges"><rect width="56" height="28" fill="#555"/><rect x="56" width="46.5" height="28" fill="#e05d44"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="100"><text transform="scale(.1)" x="280" y="175" textLength="320" fill="#fff">LANG</text><text transform="scale(.1)" x="792.5" y="175" textLength="225" fill="#fff" font-weight="bold">中文</text></g></svg>
|
||||
|
After Width: | Height: | Size: 603 B |
1
a1e5e56cbdcc97300e3228bc0aabc119_MD5.svg
Normal file
1
a1e5e56cbdcc97300e3228bc0aabc119_MD5.svg
Normal file
|
|
@ -0,0 +1 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" width="104.75" height="28" role="img" aria-label="DISCORD"><title>DISCORD</title><g shape-rendering="crispEdges"><rect width="104.75" height="28" fill="#5865f2"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="100"><image x="9" y="7" width="14" height="14" href="data:image/svg+xml;base64,PHN2ZyBmaWxsPSJ3aGl0ZSIgcm9sZT0iaW1nIiB2aWV3Qm94PSIwIDAgMjQgMjQiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHRpdGxlPkRpc2NvcmQ8L3RpdGxlPjxwYXRoIGQ9Ik0yMC4zMTcgNC4zNjk4YTE5Ljc5MTMgMTkuNzkxMyAwIDAwLTQuODg1MS0xLjUxNTIuMDc0MS4wNzQxIDAgMDAtLjA3ODUuMDM3MWMtLjIxMS4zNzUzLS40NDQ3Ljg2NDgtLjYwODMgMS4yNDk1LTEuODQ0Ny0uMjc2Mi0zLjY4LS4yNzYyLTUuNDg2OCAwLS4xNjM2LS4zOTMzLS40MDU4LS44NzQyLS42MTc3LTEuMjQ5NWEuMDc3LjA3NyAwIDAwLS4wNzg1LS4wMzcgMTkuNzM2MyAxOS43MzYzIDAgMDAtNC44ODUyIDEuNTE1LjA2OTkuMDY5OSAwIDAwLS4wMzIxLjAyNzdDLjUzMzQgOS4wNDU4LS4zMTkgMTMuNTc5OS4wOTkyIDE4LjA1NzhhLjA4MjQuMDgyNCAwIDAwLjAzMTIuMDU2MWMyLjA1MjggMS41MDc2IDQuMDQxMyAyLjQyMjggNS45OTI5IDMuMDI5NGEuMDc3Ny4wNzc3IDAgMDAuMDg0Mi0uMDI3NmMuNDYxNi0uNjMwNC44NzMxLTEuMjk1MiAxLjIyNi0xLjk5NDJhLjA3Ni4wNzYgMCAwMC0uMDQxNi0uMTA1N2MtLjY1MjgtLjI0NzYtMS4yNzQzLS41NDk1LTEuODcyMi0uODkyM2EuMDc3LjA3NyAwIDAxLS4wMDc2LS4xMjc3Yy4xMjU4LS4wOTQzLjI1MTctLjE5MjMuMzcxOC0uMjkxNGEuMDc0My4wNzQzIDAgMDEuMDc3Ni0uMDEwNWMzLjkyNzggMS43OTMzIDguMTggMS43OTMzIDEyLjA2MTQgMGEuMDczOS4wNzM5IDAgMDEuMDc4NS4wMDk1Yy4xMjAyLjA5OS4yNDYuMTk4MS4zNzI4LjI5MjRhLjA3Ny4wNzcgMCAwMS0uMDA2Ni4xMjc2IDEyLjI5ODYgMTIuMjk4NiAwIDAxLTEuODczLjg5MTQuMDc2Ni4wNzY2IDAgMDAtLjA0MDcuMTA2N2MuMzYwNC42OTguNzcxOSAxLjM2MjggMS4yMjUgMS45OTMyYS4wNzYuMDc2IDAgMDAuMDg0Mi4wMjg2YzEuOTYxLS42MDY3IDMuOTQ5NS0xLjUyMTkgNi4wMDIzLTMuMDI5NGEuMDc3LjA3NyAwIDAwLjAzMTMtLjA1NTJjLjUwMDQtNS4xNzctLjgzODItOS42NzM5LTMuNTQ4NS0xMy42NjA0YS4wNjEuMDYxIDAgMDAtLjAzMTItLjAyODZ6TTguMDIgMTUuMzMxMmMtMS4xODI1IDAtMi4xNTY5LTEuMDg1Ny0yLjE1NjktMi40MTkgMC0xLjMzMzIuOTU1NS0yLjQxODkgMi4xNTctMi40MTg5IDEuMjEwOCAwIDIuMTc1NyAxLjA5NTIgMi4xNTY4IDIuNDE5IDAgMS4zMzMyLS45NTU1IDIuNDE4OS0yLjE1NjkgMi40MTg5em03Ljk3NDggMGMtMS4xODI1IDAtMi4xNTY5LTEuMDg1Ny0yLjE1NjktMi40MTkgMC0xLjMzMzIuOTU1NC0yLjQxODkgMi4xNTY5LTIuNDE4OSAxLjIxMDggMCAyLjE3NTcgMS4wOTUyIDIuMTU2OCAyLjQxOSAwIDEuMzMzMi0uOTQ2IDIuNDE4OS0yLjE1NjggMi40MTg5WiIvPjwvc3ZnPg=="/><text transform="scale(.1)" x="623.75" y="175" textLength="607.5" fill="#fff" font-weight="bold">DISCORD</text></g></svg>
|
||||
|
After Width: | Height: | Size: 2.3 KiB |
1
f5fcdb3f89064840ca4ee81433cc5e03_MD5.svg
Normal file
1
f5fcdb3f89064840ca4ee81433cc5e03_MD5.svg
Normal file
|
|
@ -0,0 +1 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" width="331.25" height="28" role="img" aria-label="DOCS: HERMES-AGENT.NOUSRESEARCH.COM"><title>DOCS: HERMES-AGENT.NOUSRESEARCH.COM</title><g shape-rendering="crispEdges"><rect width="58" height="28" fill="#555"/><rect x="58" width="273.25" height="28" fill="#ffd700"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="100"><text transform="scale(.1)" x="290" y="175" textLength="340" fill="#fff">DOCS</text><text transform="scale(.1)" x="1946.25" y="175" textLength="2492.5" fill="#333" font-weight="bold">HERMES-AGENT.NOUSRESEARCH.COM</text></g></svg>
|
||||
|
After Width: | Height: | Size: 680 B |
178
raw/_processed/nousresearch-hermes-agent.md
Normal file
178
raw/_processed/nousresearch-hermes-agent.md
Normal file
|
|
@ -0,0 +1,178 @@
|
|||
[![[799a7f85a6cd2ee30f64fd9d7763519e_MD5.png]]](https://github.com/NousResearch/hermes-agent/blob/main/assets/banner.png)
|
||||
|
||||
## Hermes Agent ☤
|
||||
|
||||
[![[f5fcdb3f89064840ca4ee81433cc5e03_MD5.svg]]](https://hermes-agent.nousresearch.com/docs/) [![[a1e5e56cbdcc97300e3228bc0aabc119_MD5.svg]]](https://discord.gg/NousResearch) [![[4a5c465b25cfe73154c51bd2bc8758a6_MD5.svg]]](https://github.com/NousResearch/hermes-agent/blob/main/LICENSE) [![[8411fb34fe3c1ed62e71648aed13c84b_MD5.svg]]](https://nousresearch.com/) [![[8a4d52b2d756a11b786a67d977590d8e_MD5.svg]]](https://github.com/NousResearch/hermes-agent/blob/main/README.zh-CN.md)
|
||||
|
||||
**The self-improving AI agent built by [Nous Research](https://nousresearch.com/).** It's the only agent with a built-in learning loop — it creates skills from experience, improves them during use, nudges itself to persist knowledge, searches its own past conversations, and builds a deepening model of who you are across sessions. Run it on a $5 VPS, a GPU cluster, or serverless infrastructure that costs nearly nothing when idle. It's not tied to your laptop — talk to it from Telegram while it works on a cloud VM.
|
||||
|
||||
Use any model you want — [Nous Portal](https://portal.nousresearch.com/), [OpenRouter](https://openrouter.ai/) (200+ models), [NovitaAI](https://novita.ai/) (AI-native cloud for Model API, Agent Sandbox, and GPU Cloud), [NVIDIA NIM](https://build.nvidia.com/) (Nemotron), [Xiaomi MiMo](https://platform.xiaomimimo.com/), [z.ai/GLM](https://z.ai/), [Kimi/Moonshot](https://platform.moonshot.ai/), [MiniMax](https://www.minimax.io/), [Hugging Face](https://huggingface.co/), OpenAI, or your own endpoint. Switch with `hermes model` — no code changes, no lock-in.
|
||||
|
||||
| **A real terminal interface** | Full TUI with multiline editing, slash-command autocomplete, conversation history, interrupt-and-redirect, and streaming tool output. |
|
||||
| --- | --- |
|
||||
| **Lives where you do** | Telegram, Discord, Slack, WhatsApp, Signal, and CLI — all from a single gateway process. Voice memo transcription, cross-platform conversation continuity. |
|
||||
| **A closed learning loop** | Agent-curated memory with periodic nudges. Autonomous skill creation after complex tasks. Skills self-improve during use. FTS5 session search with LLM summarization for cross-session recall. [Honcho](https://github.com/plastic-labs/honcho) dialectic user modeling. Compatible with the [agentskills.io](https://agentskills.io/) open standard. |
|
||||
| **Scheduled automations** | Built-in cron scheduler with delivery to any platform. Daily reports, nightly backups, weekly audits — all in natural language, running unattended. |
|
||||
| **Delegates and parallelizes** | Spawn isolated subagents for parallel workstreams. Write Python scripts that call tools via RPC, collapsing multi-step pipelines into zero-context-cost turns. |
|
||||
| **Runs anywhere, not just your laptop** | Seven terminal backends — local, Docker, SSH, Singularity, Modal, Daytona, and Vercel Sandbox. Daytona and Modal offer serverless persistence — your agent's environment hibernates when idle and wakes on demand, costing nearly nothing between sessions. Run it on a $5 VPS or a GPU cluster. |
|
||||
| **Research-ready** | Batch trajectory generation, trajectory compression for training the next generation of tool-calling models. |
|
||||
|
||||
---
|
||||
|
||||
## Quick Install
|
||||
|
||||
### Linux, macOS, WSL2, Termux
|
||||
|
||||
```
|
||||
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
|
||||
```
|
||||
|
||||
### Windows (native, PowerShell) — Early Beta
|
||||
|
||||
> **Heads up:** Native Windows support is **early beta**. It installs and runs, but hasn't been road-tested as broadly as our Linux/macOS/WSL2 paths. Please [file issues](https://github.com/NousResearch/hermes-agent/issues) when you hit rough edges. For the most battle-tested Windows setup today, run the Linux/macOS one-liner above inside **WSL2**.
|
||||
|
||||
Run this in PowerShell:
|
||||
|
||||
```
|
||||
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
|
||||
```
|
||||
|
||||
The installer handles everything: uv, Python 3.11, Node.js, ripgrep, ffmpeg, **and a portable Git Bash** (MinGit, unpacked to `%LOCALAPPDATA%\hermes\git` — no admin required, completely isolated from any system Git install). Hermes uses this bundled Git Bash to run shell commands.
|
||||
|
||||
If you already have Git installed, the installer detects it and uses that instead. Otherwise a ~45MB MinGit download is all you need — it won't touch or interfere with any system Git.
|
||||
|
||||
> **Android / Termux:** The tested manual path is documented in the [Termux guide](https://hermes-agent.nousresearch.com/docs/getting-started/termux). On Termux, Hermes installs a curated `.[termux]` extra because the full `.[all]` extra currently pulls Android-incompatible voice dependencies.
|
||||
>
|
||||
> **Windows:** Native Windows is supported as an **early beta** — the PowerShell one-liner above installs everything, but expect rough edges and please file issues when you hit them. If you'd rather use WSL2 (our most battle-tested Windows path), the Linux command works there too. Native Windows install lives under `%LOCALAPPDATA%\hermes`; WSL2 installs under `~/.hermes` as on Linux. The only Hermes feature that currently needs WSL2 specifically is the browser-based dashboard chat pane (it uses a POSIX PTY — classic CLI and gateway both run natively).
|
||||
|
||||
After installation:
|
||||
|
||||
```
|
||||
source ~/.bashrc # reload shell (or: source ~/.zshrc)
|
||||
hermes # start chatting!
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Getting Started
|
||||
|
||||
```
|
||||
hermes # Interactive CLI — start a conversation
|
||||
hermes model # Choose your LLM provider and model
|
||||
hermes tools # Configure which tools are enabled
|
||||
hermes config set # Set individual config values
|
||||
hermes gateway # Start the messaging gateway (Telegram, Discord, etc.)
|
||||
hermes setup # Run the full setup wizard (configures everything at once)
|
||||
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
|
||||
hermes update # Update to the latest version
|
||||
hermes doctor # Diagnose any issues
|
||||
```
|
||||
|
||||
📖 **[Full documentation →](https://hermes-agent.nousresearch.com/docs/)**
|
||||
|
||||
## CLI vs Messaging Quick Reference
|
||||
|
||||
Hermes has two entry points: start the terminal UI with `hermes`, or run the gateway and talk to it from Telegram, Discord, Slack, WhatsApp, Signal, or Email. Once you're in a conversation, many slash commands are shared across both interfaces.
|
||||
|
||||
| Action | CLI | Messaging platforms |
|
||||
| --- | --- | --- |
|
||||
| Start chatting | `hermes` | Run `hermes gateway setup` + `hermes gateway start`, then send the bot a message |
|
||||
| Start fresh conversation | `/new` or `/reset` | `/new` or `/reset` |
|
||||
| Change model | `/model [provider:model]` | `/model [provider:model]` |
|
||||
| Set a personality | `/personality [name]` | `/personality [name]` |
|
||||
| Retry or undo the last turn | `/retry`, `/undo` | `/retry`, `/undo` |
|
||||
| Compress context / check usage | `/compress`, `/usage`, `/insights [--days N]` | `/compress`, `/usage`, `/insights [days]` |
|
||||
| Browse skills | `/skills` or `/<skill-name>` | `/<skill-name>` |
|
||||
| Interrupt current work | `Ctrl+C` or send a new message | `/stop` or send a new message |
|
||||
| Platform-specific status | `/platforms` | `/status`, `/sethome` |
|
||||
|
||||
For the full command lists, see the [CLI guide](https://hermes-agent.nousresearch.com/docs/user-guide/cli) and the [Messaging Gateway guide](https://hermes-agent.nousresearch.com/docs/user-guide/messaging).
|
||||
|
||||
---
|
||||
|
||||
## Documentation
|
||||
|
||||
All documentation lives at **[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs/)**:
|
||||
|
||||
| Section | What's Covered |
|
||||
| --- | --- |
|
||||
| [Quickstart](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) | Install → setup → first conversation in 2 minutes |
|
||||
| [CLI Usage](https://hermes-agent.nousresearch.com/docs/user-guide/cli) | Commands, keybindings, personalities, sessions |
|
||||
| [Configuration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) | Config file, providers, models, all options |
|
||||
| [Messaging Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
|
||||
| [Security](https://hermes-agent.nousresearch.com/docs/user-guide/security) | Command approval, DM pairing, container isolation |
|
||||
| [Tools & Toolsets](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) | 40+ tools, toolset system, terminal backends |
|
||||
| [Skills System](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) | Procedural memory, Skills Hub, creating skills |
|
||||
| [Memory](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) | Persistent memory, user profiles, best practices |
|
||||
| [MCP Integration](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) | Connect any MCP server for extended capabilities |
|
||||
| [Cron Scheduling](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) | Scheduled tasks with platform delivery |
|
||||
| [Context Files](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files) | Project context that shapes every conversation |
|
||||
| [Architecture](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) | Project structure, agent loop, key classes |
|
||||
| [Contributing](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) | Development setup, PR process, code style |
|
||||
| [CLI Reference](https://hermes-agent.nousresearch.com/docs/reference/cli-commands) | All commands and flags |
|
||||
| [Environment Variables](https://hermes-agent.nousresearch.com/docs/reference/environment-variables) | Complete env var reference |
|
||||
|
||||
---
|
||||
|
||||
## Migrating from OpenClaw
|
||||
|
||||
If you're coming from OpenClaw, Hermes can automatically import your settings, memories, skills, and API keys.
|
||||
|
||||
**During first-time setup:** The setup wizard (`hermes setup`) automatically detects `~/.openclaw` and offers to migrate before configuration begins.
|
||||
|
||||
**Anytime after install:**
|
||||
|
||||
```
|
||||
hermes claw migrate # Interactive migration (full preset)
|
||||
hermes claw migrate --dry-run # Preview what would be migrated
|
||||
hermes claw migrate --preset user-data # Migrate without secrets
|
||||
hermes claw migrate --overwrite # Overwrite existing conflicts
|
||||
```
|
||||
|
||||
What gets imported:
|
||||
|
||||
- **SOUL.md** — persona file
|
||||
- **Memories** — MEMORY.md and USER.md entries
|
||||
- **Skills** — user-created skills → `~/.hermes/skills/openclaw-imports/`
|
||||
- **Command allowlist** — approval patterns
|
||||
- **Messaging settings** — platform configs, allowed users, working directory
|
||||
- **API keys** — allowlisted secrets (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
|
||||
- **TTS assets** — workspace audio files
|
||||
- **Workspace instructions** — AGENTS.md (with `--workspace-target`)
|
||||
|
||||
See `hermes claw migrate --help` for all options, or use the `openclaw-migration` skill for an interactive agent-guided migration with dry-run previews.
|
||||
|
||||
---
|
||||
|
||||
## Contributing
|
||||
|
||||
We welcome contributions! See the [Contributing Guide](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) for development setup, code style, and PR process.
|
||||
|
||||
Quick start for contributors — clone and go with `setup-hermes.sh`:
|
||||
|
||||
```
|
||||
git clone https://github.com/NousResearch/hermes-agent.git
|
||||
cd hermes-agent
|
||||
./setup-hermes.sh # installs uv, creates venv, installs .[all], symlinks ~/.local/bin/hermes
|
||||
./hermes # auto-detects the venv, no need to \`source\` first
|
||||
```
|
||||
|
||||
Manual path (equivalent to the above):
|
||||
|
||||
```
|
||||
curl -LsSf https://astral.sh/uv/install.sh | sh
|
||||
uv venv .venv --python 3.11
|
||||
source .venv/bin/activate
|
||||
uv pip install -e ".[all,dev]"
|
||||
scripts/run_tests.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Community
|
||||
|
||||
- 💬 [Discord](https://discord.gg/NousResearch)
|
||||
- 📚 [Skills Hub](https://agentskills.io/)
|
||||
- 🐛 [Issues](https://github.com/NousResearch/hermes-agent/issues)
|
||||
- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — Linux desktop-control MCP server for Hermes and other MCP hosts, with AT-SPI accessibility trees, Wayland/X11 input, screenshots, and compositor window targeting.
|
||||
- 🔌 [HermesClaw](https://github.com/AaronWong1999/hermesclaw) — Community WeChat bridge: Run Hermes Agent and OpenClaw on the same WeChat account.
|
||||
|
|
@ -21,7 +21,7 @@ This 3-hop pattern works for hundreds of articles without vector search.
|
|||
| [[wiki/obsidian-rag/_index\|obsidian-rag/]] | Karpathy's LLM wiki method — Obsidian RAG, setup, vs true RAG | 3 |
|
||||
| [[wiki/projects-overview/_index\|projects-overview/]] | All 42 Oliver Agency projects — grouped by server (optical-web-1, optical-dev, baic, box-cli) | 1 |
|
||||
| [[wiki/tech-patterns/_index\|tech-patterns/]] | Recurring tech stacks: FastAPI, React/Vite, Next.js, Azure AD, AI, Box, One2Edit, Redis/Celery, cost-tracker, OMG API, Payload CMS | 39 |
|
||||
| [[wiki/architecture/_index\|architecture/]] | Cross-cutting architectural patterns: Docker Compose, multi-agent AI, GCP timeout, RAG, hotfolder, optical-dev deploy, cost-tracker, new-project checklist, troubleshooting playbooks, ADR log, Cloud Run Jobs | 53 |
|
||||
| [[wiki/architecture/_index\|architecture/]] | Cross-cutting architectural patterns: Docker Compose, multi-agent AI, GCP timeout, RAG, hotfolder, optical-dev deploy, cost-tracker, new-project checklist, troubleshooting playbooks, ADR log, Cloud Run Jobs | 11 |
|
||||
| [[wiki/client-knowledge/_index\|client-knowledge/]] | Per-client notes for Ford, H&M, L'Oréal, Barclays, Ferrero, 3M, BAIC | 7 |
|
||||
| [[wiki/concepts/_index\|concepts/]] | Atomic knowledge extracted from Claude Code sessions | 204 |
|
||||
| [[wiki/connections/_index\|connections/]] | Cross-cutting insights linking 2+ concepts: FastAPI+Azure AD+Docker trinity, AI→cost-tracker, Apache+Vite basePath, GCP→REST polling, Box+hotfolder, Docker DNS+AdGuard, Celery prefork×faster_whisper memory stacking | 10 |
|
||||
|
|
@ -39,6 +39,7 @@ This 3-hop pattern works for hundreds of articles without vector search.
|
|||
|
||||
| [[wiki/shared-patterns/_index\|shared-patterns/]] | Oliver Agency standard library patterns: httpx, structlog, pydantic-settings, alembic — reuse before writing from scratch | 4 |
|
||||
| [[wiki/mistakes/_index\|mistakes/]] | Anti-patterns extracted from sessions — per-stack running lists (fastapi, react, docker, postgres, general, gemini) — injected at session start | 6 |
|
||||
| [[wiki/ai-agents/_index\|ai-agents/]] | AI agent frameworks & products: NousResearch Hermes (self-improving loop, model-agnostic, multi-platform) | 1 |
|
||||
|
||||
<!-- New topic folders added here automatically as they are created -->
|
||||
<!-- Format: | [[wiki/topic/_index\|topic/]] | One-line description | N articles | -->
|
||||
|
|
|
|||
17
wiki/ai-agents/_index.md
Normal file
17
wiki/ai-agents/_index.md
Normal file
|
|
@ -0,0 +1,17 @@
|
|||
---
|
||||
title: "AI Agents Index"
|
||||
description: "AI agent frameworks and products — beyond Anthropic: NousResearch Hermes, open-weight tool-calling models, self-improving loops"
|
||||
tags: [index, ai-agents, frameworks]
|
||||
created: 2026-05-18
|
||||
updated: 2026-05-18
|
||||
---
|
||||
|
||||
# AI Agents
|
||||
|
||||
Third-party AI agent frameworks, products, and tools. For the Anthropic-specific Claude Agent SDK, see [[wiki/agent-sdk/overview|agent-sdk/]].
|
||||
|
||||
## Articles
|
||||
|
||||
| Article | Summary | Source | Updated |
|
||||
|---------|---------|--------|---------|
|
||||
| [[wiki/ai-agents/hermes-agent\|hermes-agent]] | NousResearch self-improving agent — closed learning loop, model-agnostic, Telegram/Discord/CLI, serverless backends, agentskills.io | raw/nousresearch-hermes-agent.md | 2026-05-18 |
|
||||
157
wiki/ai-agents/hermes-agent.md
Normal file
157
wiki/ai-agents/hermes-agent.md
Normal file
|
|
@ -0,0 +1,157 @@
|
|||
---
|
||||
title: "Hermes Agent — NousResearch Self-Improving AI Agent"
|
||||
aliases: [hermes-agent, nousresearch-hermes, openclaw-successor]
|
||||
tags: [ai-agent, nousresearch, self-improving, skills, memory, telegram, multi-platform]
|
||||
sources: [raw/nousresearch-hermes-agent.md]
|
||||
created: 2026-05-18
|
||||
updated: 2026-05-18
|
||||
---
|
||||
|
||||
# Hermes Agent
|
||||
|
||||
Open-source, self-improving AI agent by [Nous Research](https://nousresearch.com/). MIT licensed. Differentiator: **closed learning loop** — creates skills from experience, improves them during use, and builds a persistent user model across sessions.
|
||||
|
||||
- GitHub: `NousResearch/hermes-agent`
|
||||
- Docs: hermes-agent.nousresearch.com/docs
|
||||
|
||||
---
|
||||
|
||||
## Key Takeaways
|
||||
|
||||
- **Self-improving loop** — after complex tasks the agent autonomously creates/refines procedural "skills"; nudges itself to persist learnings to memory
|
||||
- **Model-agnostic** — OpenRouter (200+ models), NovitaAI, NVIDIA NIM, OpenAI, Anthropic, Kimi, Hugging Face, or your own endpoint; switch with `hermes model`
|
||||
- **Multi-platform** — single gateway process: Telegram, Discord, Slack, WhatsApp, Signal, Email + full TUI CLI; conversation continuity across platforms
|
||||
- **Runs anywhere** — seven terminal backends: local, Docker, SSH, Singularity, Modal, Daytona, Vercel Sandbox; serverless (Modal/Daytona hibernate when idle, ~$0 between sessions)
|
||||
- **Built-in cron** — natural-language scheduled tasks with delivery to any messaging platform
|
||||
- **Subagents + RPC** — spawn isolated parallel subagents; Python scripts call tools via RPC (zero context cost)
|
||||
- **agentskills.io** standard — skills are portable, compatible with the open Skills Hub
|
||||
- **OpenClaw migration** — `hermes claw migrate` imports settings, memories, skills, API keys from `~/.openclaw`
|
||||
|
||||
---
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
# Linux / macOS / WSL2 / Termux
|
||||
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
|
||||
source ~/.bashrc
|
||||
hermes
|
||||
```
|
||||
|
||||
```powershell
|
||||
# Windows (PowerShell, early beta)
|
||||
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
|
||||
```
|
||||
|
||||
Installer bundles: `uv`, Python 3.11, Node.js, ripgrep, ffmpeg, MinGit (Windows only).
|
||||
|
||||
---
|
||||
|
||||
## Core Commands
|
||||
|
||||
| Command | Purpose |
|
||||
|---------|---------|
|
||||
| `hermes` | Start interactive TUI |
|
||||
| `hermes model` | Choose provider + model |
|
||||
| `hermes tools` | Toggle which tools are enabled |
|
||||
| `hermes gateway` | Start messaging gateway (Telegram/Discord/etc.) |
|
||||
| `hermes setup` | Full setup wizard |
|
||||
| `hermes update` | Update to latest |
|
||||
| `hermes doctor` | Diagnose issues |
|
||||
| `hermes claw migrate` | Migrate from OpenClaw |
|
||||
|
||||
### In-session slash commands (shared: CLI + messaging)
|
||||
`/new`, `/reset`, `/model [provider:model]`, `/personality [name]`, `/retry`, `/undo`, `/compress`, `/usage`, `/insights [--days N]`, `/skills`, `/stop`
|
||||
|
||||
---
|
||||
|
||||
## Learning Loop Architecture
|
||||
|
||||
```
|
||||
Complex task completed
|
||||
↓
|
||||
Agent autonomously drafts skill (procedural memory)
|
||||
↓
|
||||
Skill stored in ~/.hermes/skills/
|
||||
↓
|
||||
Used in future sessions → self-improves during use
|
||||
↓
|
||||
FTS5 full-text search across past sessions (LLM summarization)
|
||||
↓
|
||||
Honcho dialectic user modeling → deepening user profile
|
||||
```
|
||||
|
||||
Skills conform to the **agentskills.io** open standard — importable/exportable across compatible agents.
|
||||
|
||||
---
|
||||
|
||||
## Memory System
|
||||
|
||||
- **MEMORY.md** — persistent facts the agent curates
|
||||
- **USER.md** — user profile, built by [Honcho](https://github.com/plastic-labs/honcho) dialectic modeling
|
||||
- **Session search** — FTS5 index over all past conversations, queried with LLM summarization
|
||||
- Periodic nudges prompt the agent to persist key learnings before session ends
|
||||
|
||||
---
|
||||
|
||||
## Terminal Backends
|
||||
|
||||
| Backend | Use case |
|
||||
|---------|---------|
|
||||
| Local | Default laptop/desktop |
|
||||
| Docker | Isolated container per session |
|
||||
| SSH | Remote server execution |
|
||||
| Singularity | HPC / GPU clusters |
|
||||
| Modal | Serverless, hibernates when idle |
|
||||
| Daytona | Dev environment, serverless persistence |
|
||||
| Vercel Sandbox | Edge serverless |
|
||||
|
||||
---
|
||||
|
||||
## OpenClaw Migration
|
||||
|
||||
```bash
|
||||
hermes claw migrate # interactive (full preset)
|
||||
hermes claw migrate --dry-run # preview only
|
||||
hermes claw migrate --preset user-data # no secrets
|
||||
hermes claw migrate --overwrite # overwrite conflicts
|
||||
```
|
||||
|
||||
Migrates: SOUL.md, MEMORY.md/USER.md, skills, command allowlist, messaging configs, API keys, TTS assets, AGENTS.md.
|
||||
|
||||
---
|
||||
|
||||
## vs Claude Agent SDK
|
||||
|
||||
| | Hermes Agent | [[wiki/agent-sdk/overview\|Claude Agent SDK]] |
|
||||
|---|---|---|
|
||||
| Target | End-users + developers | Developers embedding Claude in apps |
|
||||
| Model | Any (OpenRouter, etc.) | Claude only |
|
||||
| Interface | TUI + messaging bots | Programmatic (Python/TS `query()`) |
|
||||
| Skills | Self-created, agentskills.io | Skills via settingSources / CLAUDE.md |
|
||||
| Memory | Built-in (MEMORY.md + Honcho) | File-based or custom |
|
||||
| Scheduling | Built-in cron | External (hooks, infra) |
|
||||
| Deployment | VPS / serverless / GPU cluster | Your own infra |
|
||||
|
||||
---
|
||||
|
||||
## Research Features
|
||||
|
||||
- Batch trajectory generation
|
||||
- Trajectory compression for fine-tuning tool-calling models
|
||||
- Compatible with [[wiki/llm-models/openai-models\|OpenAI]], [[wiki/llm-models/claude-anthropic-models\|Anthropic]], and open-weight models
|
||||
|
||||
---
|
||||
|
||||
## Related Tools
|
||||
|
||||
- [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — Linux desktop-control MCP server (AT-SPI, Wayland/X11, screenshots)
|
||||
- [HermesClaw](https://github.com/AaronWong1999/hermesclaw) — WeChat bridge for Hermes + OpenClaw
|
||||
|
||||
---
|
||||
|
||||
## Sources
|
||||
|
||||
- `raw/nousresearch-hermes-agent.md` — official README
|
||||
- Docs: hermes-agent.nousresearch.com/docs
|
||||
- Skills Hub: agentskills.io
|
||||
Loading…
Add table
Reference in a new issue