[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AJ4RAHWNFTAD8KFVA81WJS":3,"skill-same:01M7AJ4RAHWNFTAD8KFVA81WJS":74},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":14,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":48,"updatedAt":49,"install":50,"resources":63},"01M7AJ4RAHWNFTAD8KFVA81WJS","windows-local-ai-services",null,"Run local AI services on Windows — port binding, firewall, WSL2 networking, and common pitfalls.","fack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version","fack9","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F202960557?v=4","01M7AHSF3RXNQYKYHS6AM6ZB33","D.potato","01M7AHSF4ZHGD49D5ZS6WG7BQF",0,"MIT","https:\u002F\u002Fgithub.com\u002Ffack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version\u002Fblob\u002Fmain\u002Fdangerskills\u002Fmlops\u002Fwindows-local-ai-services\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: windows-local-ai-services\ndescription: Run local AI services on Windows — port binding, firewall, WSL2 networking, and common pitfalls.\nversion: 1.0.0\nauthor: Nous Research\nlicense: MIT\nmetadata:\n  hermes:\n    tags: [Windows, WSL2, networking, ports, firewall, AI proxy, local services]\n    related_skills: [llama-cpp, serving-llms-vllm]\norigin: original\nsource_repo: kevinnft\u002Fai-agent-skills\nsource_url: https:\u002F\u002Fgithub.com\u002Fkevinnft\u002Fai-agent-skills\nsource_license: MIT\nlanguage: en\n---\n\n# Windows Local AI Services\n\nRunning local AI services (enowxai, Ollama, LM Studio, vLLM, llama.cpp servers) on Windows has specific networking and port binding pitfalls. This skill covers setup, troubleshooting, and WSL2 cross-OS access.\n\n## References\n\n- `references\u002Fwindows-port-restrictions.md` — Windows reserved port ranges and binding errors\n- `references\u002Fheadless-gui-apps.md` — Running GUI apps in headless WSL2 with Xvfb\n\n## Common Pitfalls\n\n### 1. **Port Binding Failures**\n\n**Symptom**: Service crashes immediately with:\n```\nERROR failed to start error=\"listen tcp4 127.0.0.1:1430: bind: An attempt was made to access a socket in a way forbidden by its access permissions.\"\n```\n\n**Root Cause**: Windows reserves certain port ranges for system services (Hyper-V, WinNAT, dynamic port allocation). Ports in these ranges cannot be bound by user applications.\n\n**Fix**:\n1. **Change the port** (easiest):\n   ```powershell\n   # Use a port outside reserved ranges (8000-9000 is usually safe)\n   service start --port 8430\n   ```\n\n2. **Check reserved ranges**:\n   ```powershell\n   netsh int ipv4 show dynamicport tcp\n   netsh int ipv4 show excludedportrange protocol=tcp\n   ```\n\n3. **Exclude a specific port** (risky, can conflict with system services):\n   ```powershell\n   netsh int ipv4 add excludedportrange protocol=tcp startport=1430 numberofports=1\n   ```\n\n**Never kill `svchost.exe`** — it's a Windows system service host. If `netstat` shows `svchost` using your target port, the port is reserved by Windows.\n\n### 2. **WSL2 Cross-OS Networking**\n\n**Symptom**: Service runs on Windows but WSL2 cannot connect via `localhost`.\n\n**Root Cause**: WSL2 uses a virtualized network. `localhost` in WSL2 points to the WSL2 VM, not the Windows host.\n\n**Fix**:\n1. **Use Windows host gateway IP** from WSL2:\n   ```bash\n   # Get Windows host IP (usually 172.17.16.1, but can change on reboot)\n   ip route show default | awk '{print $3}'\n   \n   # Test connection\n   curl http:\u002F\u002F172.17.16.1:8430\u002Fv1\u002Fmodels\n   ```\n\n2. **Ensure Windows service listens on 0.0.0.0** (not 127.0.0.1):\n   ```powershell\n   # Check listening address\n   netstat -ano | findstr :8430\n   \n   # Should show 0.0.0.0:8430, not 127.0.0.1:8430\n   ```\n\n3. **Configure Windows Firewall**:\n   ```powershell\n   # Allow inbound on the service port\n   New-NetFirewallRule -DisplayName \"AI Service Port 8430\" -Direction Inbound -LocalPort 8430 -Protocol TCP -Action Allow\n   ```\n\n### 3. **Process Already Running**\n\n**Symptom**: Service says \"port already in use\" but `Get-Process` shows nothing.\n\n**Diagnosis**:\n```powershell\n# Find what's using the port\nnetstat -ano | findstr :8430\n\n# Get process details (replace 1234 with PID from netstat)\nGet-Process -Id 1234 | Select-Object Name, Id, Path\n```\n\n**Fix**:\n- If it's your service from a previous run: kill it and restart\n- If it's `svchost` or another system service: change your service's port\n\n### 4. **Service Crashes Silently**\n\n**Always check logs first**:\n```powershell\n# Common log locations\nGet-Content ~\\.service-name\\service.log -Tail 50\nGet-Content $env:APPDATA\\service-name\\logs\\latest.log -Tail 50\n```\n\n**Common causes**:\n- Missing dependencies (Python, CUDA\u002FROCm, Visual C++ Redistributable)\n- Config file syntax errors\n- Permission issues (try running PowerShell as Administrator)\n\n## Setup Checklist\n\nWhen setting up a new local AI service on Windows:\n\n1. **Choose a safe port** (8000-9000 range recommended)\n2. **Configure to listen on 0.0.0.0** (not 127.0.0.1) if WSL2 access needed\n3. **Add Windows Firewall rule** for the port\n4. **Test from Windows** first: `curl http:\u002F\u002Flocalhost:PORT\u002Fhealth`\n5. **Test from WSL2**: `curl http:\u002F\u002F$(ip route show default | awk '{print $3}'):PORT\u002Fhealth`\n6. **Save the gateway IP** or add to WSL2 `~\u002F.bashrc`:\n   ```bash\n   export WINDOWS_HOST=$(ip route show default | awk '{print $3}')\n   export AI_SERVICE_URL=\"http:\u002F\u002F$WINDOWS_HOST:8430\u002Fv1\"\n   ```\n\n## Verification\n\nAfter setup, verify cross-OS connectivity:\n\n```bash\n# From WSL2\nGATEWAY_IP=$(ip route show default | awk '{print $3}')\necho \"Windows host IP: $GATEWAY_IP\"\n\n# Test connection\ncurl -s http:\u002F\u002F$GATEWAY_IP:8430\u002Fv1\u002Fmodels | jq .\n\n# If it works, save to config\necho \"export AI_SERVICE_URL=http:\u002F\u002F$GATEWAY_IP:8430\u002Fv1\" >> ~\u002F.bashrc\n```\n\n## Rules\n\n1. **Always check logs before guessing** — most errors are explicit\n2. **Never kill system processes** (svchost, System, services.exe)\n3. **Use gateway IP for WSL2 → Windows** — never `localhost`\n4. **Verify firewall rules** before blaming the service\n5. **Document the port** — save it in config files, not just command-line flags\n","# Windows Local AI Services\n\nRunning local AI services (enowxai, Ollama, LM Studio, vLLM, llama.cpp servers) on Windows has specific networking and port binding pitfalls. This skill covers setup, troubleshooting, and WSL2 cross-OS access.\n\n## References\n\n- `references\u002Fwindows-port-restrictions.md` — Windows reserved port ranges and binding errors\n- `references\u002Fheadless-gui-apps.md` — Running GUI apps in headless WSL2 with Xvfb\n\n## Common Pitfalls\n\n### 1. **Port Binding Failures**\n\n**Symptom**: Service crashes immediately with:\n```\nERROR failed to start error=\"listen tcp4 127.0.0.1:1430: bind: An attempt was made to access a socket in a way forbidden by its access permissions.\"\n```\n\n**Root Cause**: Windows reserves certain port ranges for system services (Hyper-V, WinNAT, dynamic port allocation). Ports in these ranges cannot be bound by user applications.\n\n**Fix**:\n1. **Change the port** (easiest):\n   ```powershell\n   # Use a port outside reserved ranges (8000-9000 is usually safe)\n   service start --port 8430\n   ```\n\n2. **Check reserved ranges**:\n   ```powershell\n   netsh int ipv4 show dynamicport tcp\n   netsh int ipv4 show excludedportrange protocol=tcp\n   ```\n\n3. **Exclude a specific port** (risky, can conflict with system services):\n   ```powershell\n   netsh int ipv4 add excludedportrange protocol=tcp startport=1430 numberofports=1\n   ```\n\n**Never kill `svchost.exe`** — it's a Windows system service host. If `netstat` shows `svchost` using your target port, the port is reserved by Windows.\n\n### 2. **WSL2 Cross-OS Networking**\n\n**Symptom**: Service runs on Windows but WSL2 cannot connect via `localhost`.\n\n**Root Cause**: WSL2 uses a virtualized network. `localhost` in WSL2 points to the WSL2 VM, not the Windows host.\n\n**Fix**:\n1. **Use Windows host gateway IP** from WSL2:\n   ```bash\n   # Get Windows host IP (usually 172.17.16.1, but can change on reboot)\n   ip route show default | awk '{print $3}'\n   \n   # Test connection\n   curl http:\u002F\u002F172.17.16.1:8430\u002Fv1\u002Fmodels\n   ```\n\n2. **Ensure Windows service listens on 0.0.0.0** (not 127.0.0.1):\n   ```powershell\n   # Check listening address\n   netstat -ano | findstr :8430\n   \n   # Should show 0.0.0.0:8430, not 127.0.0.1:8430\n   ```\n\n3. **Configure Windows Firewall**:\n   ```powershell\n   # Allow inbound on the service port\n   New-NetFirewallRule -DisplayName \"AI Service Port 8430\" -Direction Inbound -LocalPort 8430 -Protocol TCP -Action Allow\n   ```\n\n### 3. **Process Already Running**\n\n**Symptom**: Service says \"port already in use\" but `Get-Process` shows nothing.\n\n**Diagnosis**:\n```powershell\n# Find what's using the port\nnetstat -ano | findstr :8430\n\n# Get process details (replace 1234 with PID from netstat)\nGet-Process -Id 1234 | Select-Object Name, Id, Path\n```\n\n**Fix**:\n- If it's your service from a previous run: kill it and restart\n- If it's `svchost` or another system service: change your service's port\n\n### 4. **Service Crashes Silently**\n\n**Always check logs first**:\n```powershell\n# Common log locations\nGet-Content ~\\.service-name\\service.log -Tail 50\nGet-Content $env:APPDATA\\service-name\\logs\\latest.log -Tail 50\n```\n\n**Common causes**:\n- Missing dependencies (Python, CUDA\u002FROCm, Visual C++ Redistributable)\n- Config file syntax errors\n- Permission issues (try running PowerShell as Administrator)\n\n## Setup Checklist\n\nWhen setting up a new local AI service on Windows:\n\n1. **Choose a safe port** (8000-9000 range recommended)\n2. **Configure to listen on 0.0.0.0** (not 127.0.0.1) if WSL2 access needed\n3. **Add Windows Firewall rule** for the port\n4. **Test from Windows** first: `curl http:\u002F\u002Flocalhost:PORT\u002Fhealth`\n5. **Test from WSL2**: `curl http:\u002F\u002F$(ip route show default | awk '{print $3}'):PORT\u002Fhealth`\n6. **Save the gateway IP** or add to WSL2 `~\u002F.bashrc`:\n   ```bash\n   export WINDOWS_HOST=$(ip route show default | awk '{print $3}')\n   export AI_SERVICE_URL=\"http:\u002F\u002F$WINDOWS_HOST:8430\u002Fv1\"\n   ```\n\n## Verification\n\nAfter setup, verify cross-OS connectivity:\n\n```bash\n# From WSL2\nGATEWAY_IP=$(ip route show default | awk '{print $3}')\necho \"Windows host IP: $GATEWAY_IP\"\n\n# Test connection\ncurl -s http:\u002F\u002F$GATEWAY_IP:8430\u002Fv1\u002Fmodels | jq .\n\n# If it works, save to config\necho \"export AI_SERVICE_URL=http:\u002F\u002F$GATEWAY_IP:8430\u002Fv1\" >> ~\u002F.bashrc\n```\n\n## Rules\n\n1. **Always check logs before guessing** — most errors are explicit\n2. **Never kill system processes** (svchost, System, services.exe)\n3. **Use gateway IP for WSL2 → Windows** — never `localhost`\n4. **Verify firewall rules** before blaming the service\n5. **Document the port** — save it in config files, not just command-line flags\n",{"name":5,"author":24,"origin":25,"license":15,"version":26,"language":27,"metadata":28,"source_url":41,"description":7,"source_repo":42,"source_license":15},"Nous Research","original","1.0.0","en",{"hermes":29},{"tags":30,"related_skills":38},[31,32,33,34,35,36,37],"Windows","WSL2","networking","ports","firewall","AI proxy","local services",[39,40],"llama-cpp","serving-llms-vllm","https:\u002F\u002Fgithub.com\u002Fkevinnft\u002Fai-agent-skills","kevinnft\u002Fai-agent-skills","main","69027028eac3c79de494a6221ef59fa35f375e17","dangerskills\u002Fmlops\u002Fwindows-local-ai-services","https:\u002F\u002Fgithub.com\u002Ffack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version","https:\u002F\u002Fgithub.com\u002Ffack9","happy potato","2026-08-14 22:20:00",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add fack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version --skill windows-local-ai-services",{"tool":56,"command":57},"bunx","bunx skills add fack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version --skill windows-local-ai-services",{"tool":59,"command":60},"pnpm","pnpm dlx skills add fack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version --skill windows-local-ai-services","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ffack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version\u002Fblob\u002Fmain\u002Fdangerskills\u002Fmlops\u002Fwindows-local-ai-services\u002FSKILL.md",true,[64,70],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"references\u002Fheadless-gui-apps.md","REFERENCE","参考文档",3412,"https:\u002F\u002Fgithub.com\u002Ffack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version\u002Fblob\u002Fmain\u002Fdangerskills\u002Fmlops\u002Fwindows-local-ai-services\u002Freferences\u002Fheadless-gui-apps.md",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"references\u002Fwindows-port-restrictions.md",3706,"https:\u002F\u002Fgithub.com\u002Ffack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version\u002Fblob\u002Fmain\u002Fdangerskills\u002Fmlops\u002Fwindows-local-ai-services\u002Freferences\u002Fwindows-port-restrictions.md",[75,82,89,96,103,110],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7AJ759A28YKM24TC8YX3NYF","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002Ffack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version\u002Fblob\u002Fmain\u002Fdangerskills\u002Fsocial-media\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7AJ65D1DTG6H77XHJBXYZWM","research-paper-writing","Write ML papers for NeurIPS\u002FICML\u002FICLR: design→submit.","https:\u002F\u002Fgithub.com\u002Ffack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version\u002Fblob\u002Fmain\u002Fdangerskills\u002Fresearch\u002Fresearch-paper-writing\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7AJ5S676GQAT1X16P38JM26","llm-wiki","Karpathy's LLM Wiki: build\u002Fquery interlinked markdown KB.","https:\u002F\u002Fgithub.com\u002Ffack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version\u002Fblob\u002Fmain\u002Fdangerskills\u002Fresearch\u002Fllm-wiki\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M7AJ56JWMA41G8DGMS249SK0","blogwatcher","Monitor blogs and RSS\u002FAtom feeds via blogwatcher-cli tool.","https:\u002F\u002Fgithub.com\u002Ffack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version\u002Fblob\u002Fmain\u002Fdangerskills\u002Fresearch\u002Fblogwatcher\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M7AJ52DFWF6QRW58Z9WT1RBZ","arxiv","Search arXiv papers by keyword, author, category, or ID.","https:\u002F\u002Fgithub.com\u002Ffack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version\u002Fblob\u002Fmain\u002Fdangerskills\u002Fresearch\u002Farxiv\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":19},"01M7AJ4VZEKQ3A47FMKGNJEWMV","godmode","Jailbreak LLMs: Parseltongue, GODMODE, ULTRAPLINIAN.","https:\u002F\u002Fgithub.com\u002Ffack9\u002FTUDOU_Agent_Z4NCGH_3.12.2.2_version\u002Fblob\u002Fmain\u002Fdangerskills\u002Fred-teaming\u002Fgodmode\u002FSKILL.md",[],[]]