diff --git a/01 Projects/hp-prod-tracker/DEVELOPER_MANUAL.md b/01 Projects/hp-prod-tracker/DEVELOPER_MANUAL.md index 13c4bf5..121d412 100644 --- a/01 Projects/hp-prod-tracker/DEVELOPER_MANUAL.md +++ b/01 Projects/hp-prod-tracker/DEVELOPER_MANUAL.md @@ -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`. \ No newline at end of file +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]] \ No newline at end of file diff --git a/01 Projects/hp-prod-tracker/USER_MANUAL.md b/01 Projects/hp-prod-tracker/USER_MANUAL.md index 28f8c20..e80a9b6 100644 --- a/01 Projects/hp-prod-tracker/USER_MANUAL.md +++ b/01 Projects/hp-prod-tracker/USER_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. \ No newline at end of file +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]] \ No newline at end of file diff --git a/01 Projects/loreal-sla-calculator/DEVELOPER_MANUAL.md b/01 Projects/loreal-sla-calculator/DEVELOPER_MANUAL.md index fe7f871..b7cf293 100644 --- a/01 Projects/loreal-sla-calculator/DEVELOPER_MANUAL.md +++ b/01 Projects/loreal-sla-calculator/DEVELOPER_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. \ No newline at end of file +- **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]] \ No newline at end of file diff --git a/01 Projects/loreal-sla-calculator/USER_MANUAL.md b/01 Projects/loreal-sla-calculator/USER_MANUAL.md index 27c2a10..9025cf8 100644 --- a/01 Projects/loreal-sla-calculator/USER_MANUAL.md +++ b/01 Projects/loreal-sla-calculator/USER_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. \ No newline at end of file +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]] \ No newline at end of file diff --git a/01 Projects/loreal-timelog-viewer/DEVELOPER_MANUAL.md b/01 Projects/loreal-timelog-viewer/DEVELOPER_MANUAL.md index fda54dc..3bf739e 100644 --- a/01 Projects/loreal-timelog-viewer/DEVELOPER_MANUAL.md +++ b/01 Projects/loreal-timelog-viewer/DEVELOPER_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 diff --git a/01 Projects/loreal-timelog-viewer/USER_MANUAL.md b/01 Projects/loreal-timelog-viewer/USER_MANUAL.md index 22b59e0..a7961a1 100644 --- a/01 Projects/loreal-timelog-viewer/USER_MANUAL.md +++ b/01 Projects/loreal-timelog-viewer/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: User_Manual +status: active +tags: +- client/loreal +- domain/analytics +- status/active +- type/sop +type: sop --- # Loreal Timelog Viewer User Manual diff --git a/01 Projects/md to word/DEVELOPER_MANUAL.md b/01 Projects/md to word/DEVELOPER_MANUAL.md index 07192bc..2700c2d 100644 --- a/01 Projects/md to word/DEVELOPER_MANUAL.md +++ b/01 Projects/md to word/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: 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. \ No newline at end of file diff --git a/01 Projects/md to word/USER_MANUAL.md b/01 Projects/md to word/USER_MANUAL.md index ff15718..31e11e0 100644 --- a/01 Projects/md to word/USER_MANUAL.md +++ b/01 Projects/md to word/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: 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]] \ No newline at end of file diff --git a/01 Projects/semblance/DEVELOPER_MANUAL.md b/01 Projects/semblance/DEVELOPER_MANUAL.md index 159f5a2..298b1e2 100644 --- a/01 Projects/semblance/DEVELOPER_MANUAL.md +++ b/01 Projects/semblance/DEVELOPER_MANUAL.md @@ -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. \ No newline at end of file + 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]] \ No newline at end of file diff --git a/01 Projects/semblance/USER_MANUAL.md b/01 Projects/semblance/USER_MANUAL.md index 2320596..63346fc 100644 --- a/01 Projects/semblance/USER_MANUAL.md +++ b/01 Projects/semblance/USER_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. \ No newline at end of file +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]] \ No newline at end of file diff --git a/01 Projects/video-accessibility-old/DEVELOPER_MANUAL.md b/01 Projects/video-accessibility-old/DEVELOPER_MANUAL.md index 579d052..9686882 100644 --- a/01 Projects/video-accessibility-old/DEVELOPER_MANUAL.md +++ b/01 Projects/video-accessibility-old/DEVELOPER_MANUAL.md @@ -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. \ No newline at end of file +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]] \ No newline at end of file diff --git a/01 Projects/video-accessibility-old/USER_MANUAL.md b/01 Projects/video-accessibility-old/USER_MANUAL.md index 7644008..706c6a9 100644 --- a/01 Projects/video-accessibility-old/USER_MANUAL.md +++ b/01 Projects/video-accessibility-old/USER_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. \ No newline at end of file +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]] \ No newline at end of file diff --git a/05 Aimpress LTD/Shumiland/Shumiland.md b/05 Aimpress LTD/Shumiland/Shumiland.md index 671ce96..4f263a7 100644 --- a/05 Aimpress LTD/Shumiland/Shumiland.md +++ b/05 Aimpress LTD/Shumiland/Shumiland.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]] \ No newline at end of file diff --git a/4a5c465b25cfe73154c51bd2bc8758a6_MD5.svg b/4a5c465b25cfe73154c51bd2bc8758a6_MD5.svg new file mode 100644 index 0000000..0a2c371 --- /dev/null +++ b/4a5c465b25cfe73154c51bd2bc8758a6_MD5.svg @@ -0,0 +1 @@ +LICENSE: MITLICENSEMIT \ No newline at end of file diff --git a/799a7f85a6cd2ee30f64fd9d7763519e_MD5.png b/799a7f85a6cd2ee30f64fd9d7763519e_MD5.png new file mode 100644 index 0000000..2c4a160 Binary files /dev/null and b/799a7f85a6cd2ee30f64fd9d7763519e_MD5.png differ diff --git a/8411fb34fe3c1ed62e71648aed13c84b_MD5.svg b/8411fb34fe3c1ed62e71648aed13c84b_MD5.svg new file mode 100644 index 0000000..63f55d6 --- /dev/null +++ b/8411fb34fe3c1ed62e71648aed13c84b_MD5.svg @@ -0,0 +1 @@ +BUILT BY: NOUS RESEARCHBUILT BYNOUS RESEARCH \ No newline at end of file diff --git a/8a4d52b2d756a11b786a67d977590d8e_MD5.svg b/8a4d52b2d756a11b786a67d977590d8e_MD5.svg new file mode 100644 index 0000000..50b64f2 --- /dev/null +++ b/8a4d52b2d756a11b786a67d977590d8e_MD5.svg @@ -0,0 +1 @@ +LANG: 中文LANG中文 \ No newline at end of file diff --git a/a1e5e56cbdcc97300e3228bc0aabc119_MD5.svg b/a1e5e56cbdcc97300e3228bc0aabc119_MD5.svg new file mode 100644 index 0000000..3e6132d --- /dev/null +++ b/a1e5e56cbdcc97300e3228bc0aabc119_MD5.svg @@ -0,0 +1 @@ +DISCORDDISCORD \ No newline at end of file diff --git a/f5fcdb3f89064840ca4ee81433cc5e03_MD5.svg b/f5fcdb3f89064840ca4ee81433cc5e03_MD5.svg new file mode 100644 index 0000000..bc46ca5 --- /dev/null +++ b/f5fcdb3f89064840ca4ee81433cc5e03_MD5.svg @@ -0,0 +1 @@ +DOCS: HERMES-AGENT.NOUSRESEARCH.COMDOCSHERMES-AGENT.NOUSRESEARCH.COM \ No newline at end of file diff --git a/raw/_processed/nousresearch-hermes-agent.md b/raw/_processed/nousresearch-hermes-agent.md new file mode 100644 index 0000000..d58516f --- /dev/null +++ b/raw/_processed/nousresearch-hermes-agent.md @@ -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 `/` | `/` | +| 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. \ No newline at end of file diff --git a/wiki/_master-index.md b/wiki/_master-index.md index 7c3c4e4..7694c3c 100644 --- a/wiki/_master-index.md +++ b/wiki/_master-index.md @@ -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 | diff --git a/wiki/ai-agents/_index.md b/wiki/ai-agents/_index.md new file mode 100644 index 0000000..6a7658b --- /dev/null +++ b/wiki/ai-agents/_index.md @@ -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 | diff --git a/wiki/ai-agents/hermes-agent.md b/wiki/ai-agents/hermes-agent.md new file mode 100644 index 0000000..04464e3 --- /dev/null +++ b/wiki/ai-agents/hermes-agent.md @@ -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