vault backup: 2026-05-18 19:41:01

This commit is contained in:
Vadym Samoilenko 2026-05-18 19:41:01 +01:00
parent 1480da7e44
commit fe3278e7ab
23 changed files with 589 additions and 19 deletions

View file

@ -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]]

View file

@ -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]]

View file

@ -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]]

View file

@ -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]]

View file

@ -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

View file

@ -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

View file

@ -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.

View file

@ -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]]

View file

@ -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]]

View file

@ -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]]

View file

@ -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]]

View file

@ -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]]

View file

@ -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]]

View 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

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

View 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

View 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

View 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

View 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

View 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.

View file

@ -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
View 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 |

View 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