[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75DN18REKAQGEBY36JR4S97":3,"skill-same:01M75DN18REKAQGEBY36JR4S97":46},{"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":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M75DN18REKAQGEBY36JR4S97","ov-server-operate",null,"Operate and maintain OpenViking server - configure, install, start, stop, and cleanup the server. Use when need to setup or manage OpenViking service deployment.","zhangmask\u002FC_AnimeCompanion","zhangmask","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142085030?v=4","01M75DE4RMVR0PZNRT2CHBNB1K","Zeshan Zhang","01M75DE4SE8VQSYG2PMV66F3PE",2,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002FOpenViking-main\u002FOpenViking-main\u002Fexamples\u002Fskills\u002Fov-server-operate\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: ov-server-operate\ndescription: Operate and maintain OpenViking server - configure, install, start, stop, and cleanup the server. Use when need to setup or manage OpenViking service deployment.\ncompatibility: OpenViking CLI configured at `~\u002F.openviking\u002Fovcli.conf`\n---\n\n# OpenViking Server Operations\n\nThis guide provides standard operating procedures for deploying, managing, and maintaining OpenViking servers in production environments.\n\n## Table of Content\n- Service Configuration\n- Environment Setup with uv\n- Server Startup with nohup\n- Server Shutdown\n- Data Cleanup Procedure\n- Verification and Troubleshooting\n\n## Service Configuration\n\n### Default Paths and Structure\n\nOpenViking uses the following standard directory structure under `~\u002F.openviking\u002F`:\n\n```\n~\u002F.openviking\u002F\n├── ov.conf             # Server configuration (required)\n├── ovcli.conf          # CLI client configuration\n├── ov-venv\u002F            # Virtual environment (created by uv)\n├── log\u002F                # Server log directory\n│   ├── openviking-server.log   # server stdout log\n│   └── openviking.log          # server log\n└── data\u002F               # Workspace data (configured in ov.conf)\n    ├── ...\n    └── ...\n```\n\n### Configuration Files\n\n#### 1. Server Config (`~\u002F.openviking\u002Fov.conf`)\n\nCreate the configuration file with at minimum the following configuration.\nNote 1: Replace the api-key with your own api-key. If you don't have one, ask the user to get one (follow the Volcengine Ark platform guide).\nNote 2: Replace the root_api_key with your own root-api-key. Ask the user to set one — it will be used for authentication when the CLI connects to the server.\n\n```json\n{\n  \"server\": {\n    \"host\": \"0.0.0.0\",\n    \"port\": 1933,\n    \"root_api_key\": \"your-root-api-key\"\n  },\n  \"storage\": {\n    \"workspace\": \"~\u002F.openviking\u002Fdata\u002F\"\n  },\n  \"parsers\": {\n    \"code\": {\n      \"gitlab_domains\": [\"code.byted.org\"],\n      \"azure_devops_domains\": [\"ssh.dev.azure.com\", \"vs-ssh.visualstudio.com\"]\n    }\n  },\n  \"embedding\": {\n    \"dense\": {\n        \"model\": \"doubao-embedding-vision-251215\",\n        \"api_key\": \"your-volcengine-api-key\",\n        \"api_base\": \"https:\u002F\u002Fark.cn-beijing.volces.com\u002Fapi\u002Fv3\",\n        \"dimension\": 1024,\n        \"input\": \"multimodal\",\n        \"provider\": \"volcengine\"\n    }\n  },\n  \"vlm\": {\n    \"model\": \"doubao-seed-1-8-251228\",\n    \"api_key\": \"your-volcengine-api-key\",\n    \"api_base\": \"https:\u002F\u002Fark.cn-beijing.volces.com\u002Fapi\u002Fv3\",\n    \"temperature\": 0.0,\n    \"max_retries\": 2,\n    \"provider\": \"volcengine\",\n    \"thinking\": false\n  },\n  \"log\": {\n    \"level\": \"INFO\",\n    \"output\": \"file\",\n    \"rotation\": true,\n    \"rotation_days\": 3,\n    \"rotation_interval\": \"midnight\"\n  }\n}\n```\n\n#### 2. CLI Config (`~\u002F.openviking\u002Fovcli.conf`)\n\nFor client connections from localhost:\n\n```json\n{\n  \"url\": \"http:\u002F\u002Flocalhost:1933\",\n  \"api_key\": \"your-root-api-key\"\n}\n```\n\nFor remote connections, set the url to the remote server address (for example, the server EIP).\n\n## Environment Setup with uv\n\n### Step 1: Install uv (if not already installed)\n\n```bash\n# macOS\u002FLinux\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# Verify installation\nuv --version\n```\n\n### Step 2: Create Virtual Environment\n\nCreate a dedicated virtual environment at `~\u002F.openviking\u002Fov-venv`:\n\n```bash\n# Create venv with Python 3.10+\ncd ~\u002F.openviking\nuv venv --python 3.12 ov-venv\n```\n\n### Step 3: Activate and Install OpenViking\n\n```bash\n# Activate the virtual environment\nsource ~\u002F.openviking\u002Fov-venv\u002Fbin\u002Factivate\n\n# Install or upgrade to latest openviking\nuv pip install --upgrade openviking --force-reinstall\n\n# Verify installation\nwhich openviking-server\nopenviking-server --version\nopenviking-server --help\n```\n\n### Step 4: Create Log Directory\n\n```bash\nmkdir -p ~\u002F.openviking\u002Flog\n```\n\n## Server Startup with nohup\n\n### Standard Startup Procedure\n\n```bash\n# 1. Activate the virtual environment\nsource ~\u002F.openviking\u002Fov-venv\u002Fbin\u002Factivate\n\n# 2. Ensure log directory exists\nmkdir -p ~\u002F.openviking\u002Flog\n\n# 3. Start server with nohup\nnohup openviking-server \\\n    > ~\u002F.openviking\u002Flog\u002Fopenviking-server.log 2>&1 &\n\n# 4. Save PID for later reference\necho $! > ~\u002F.openviking\u002Fserver.pid\n\n# 5. Verify startup after 10 secs\nsleep 10\ncurl -s http:\u002F\u002Flocalhost:1933\u002Fhealth\n```\n\n### Verify Server is Running\n\n```bash\n# Method 1: Check health endpoint\ncurl http:\u002F\u002Flocalhost:1933\u002Fhealth\n# Expected: {\"status\": \"ok\"}\n\n# Method 2: Check readiness (includes storage checks)\ncurl http:\u002F\u002Flocalhost:1933\u002Fready\n\n# Method 3: Check process\nps aux | grep openviking-server | grep -v grep\n\n# Method 4: Check log output\ntail -10 ~\u002F.openviking\u002Flog\u002Fopenviking-server.log\ntail -50 ~\u002F.openviking\u002Flog\u002Fopenviking.log\n```\n\n## Server Shutdown\n\n### Graceful Shutdown Procedure\n\n```bash\n# 1. Find the server process\nps aux | grep openviking-server | grep -v grep\n\n# 2. Send SIGTERM for graceful shutdown\n# Option A: Using saved PID\nif [ -f ~\u002F.openviking\u002Fserver.pid ]; then\n    kill $(cat ~\u002F.openviking\u002Fserver.pid)\n    rm ~\u002F.openviking\u002Fserver.pid\nfi\n\n# Option B: Using pgrep\npkill -f openviking-server\n\n# 3. Wait for process to stop\nsleep 3\n\n# 4. Verify it stopped\nps aux | grep openviking-server | grep -v grep || echo \"Server stopped successfully\"\n\n# 5. If still running, force kill\nif pgrep -f openviking-server > \u002Fdev\u002Fnull; then\n    echo \"Force killing server...\"\n    pkill -9 -f openviking-server\nfi\n```\n\n## Data Cleanup Procedure\n\n### When to Use This Procedure\n\nPerform full data cleanup in these scenarios:\n1. Version upgrade with incompatible data format\n2. Corrupted or inconsistent data\n3. Need to reset to fresh state\n4. Storage space reclamation\n\n### Standard Cleanup Workflow\n\n**CRITICAL: ALWAYS BACKUP BEFORE DELETING DATA**\n\n```bash\n# ==========================================\n# STEP 1: STOP THE SERVER FIRST\n# ==========================================\necho \"Step 1: Stopping OpenViking Server...\"\nif pgrep -f openviking-server > \u002Fdev\u002Fnull; then\n    pkill -f openviking-server\n    sleep 3\n    if pgrep -f openviking-server > \u002Fdev\u002Fnull; then\n        pkill -9 -f openviking-server\n        sleep 1\n    fi\nfi\n\n# Verify server is stopped\nif pgrep -f openviking-server > \u002Fdev\u002Fnull; then\n    echo \"ERROR: Server still running! Cannot proceed.\"\n    exit 1\nfi\necho \"✓ Server stopped\"\n\n# ==========================================\n# STEP 2: CREATE BACKUP (REQUIRED)\n# ==========================================\necho \"\"\necho \"Step 2: Creating backup...\"\nBACKUP_DATE=$(date +%Y%m%d_%H%M%S)\nBACKUP_DIR=~\u002F.openviking\u002Fbackup_${BACKUP_DATE}\n\nmkdir -p ${BACKUP_DIR}\n\n# Backup config files\ncp ~\u002F.openviking\u002Fov.conf ${BACKUP_DIR}\u002F 2>\u002Fdev\u002Fnull || true\ncp ~\u002F.openviking\u002Fovcli.conf ${BACKUP_DIR}\u002F 2>\u002Fdev\u002Fnull || true\n\n# Backup workspace (if exists)\nWORKSPACE=$(python3 -c '\nimport json\nimport os\nconfig_path = os.path.expanduser(\"~\u002F.openviking\u002Fov.conf\")\nif os.path.exists(config_path):\n    with open(config_path) as f:\n        cfg = json.load(f)\n        ws = cfg.get(\"storage\", {}).get(\"workspace\", \".\u002Fdata\")\n        print(os.path.expanduser(ws))\n' 2>\u002Fdev\u002Fnull || echo \"~\u002F.openviking\u002Fdata\")\n\nif [ -d \"${WORKSPACE}\" ]; then\n    echo \"Backing up workspace: ${WORKSPACE}\"\n    tar -czf ${BACKUP_DIR}\u002Fworkspace_backup.tar.gz -C $(dirname ${WORKSPACE}) $(basename ${WORKSPACE})\nfi\n\n# Backup log\nif [ -d ~\u002F.openviking\u002Flog ]; then\n    cp -r ~\u002F.openviking\u002Flog ${BACKUP_DIR}\u002F 2>\u002Fdev\u002Fnull || true\nfi\n\necho \"✓ Backup created at: ${BACKUP_DIR}\"\nls -lh ${BACKUP_DIR}\u002F\n\n# ==========================================\n# STEP 3: CONFIRM DELETION\n# ==========================================\necho \"\"\necho \"==========================================\"\necho \"WARNING: ABOUT TO DELETE ALL DATA!\"\necho \"==========================================\"\necho \"Workspace to delete: ${WORKSPACE}\"\necho \"Backup location: ${BACKUP_DIR}\"\necho \"\"\nread -p \"Type 'DELETE' to confirm data removal: \" CONFIRM\n\nif [ \"${CONFIRM}\" != \"DELETE\" ]; then\n    echo \"Cleanup cancelled. Backup preserved at ${BACKUP_DIR}\"\n    exit 0\nfi\n\n# ==========================================\n# STEP 4: DELETE DATA\n# ==========================================\necho \"\"\necho \"Step 4: Deleting data...\"\n\n# Delete workspace\nif [ -d \"${WORKSPACE}\" ]; then\n    echo \"Deleting workspace: ${WORKSPACE}\"\n    rm -rf \"${WORKSPACE}\"\nfi\n\n# Optional: Delete old log (uncomment if needed)\n# echo \"Deleting old log...\"\n# rm -rf ~\u002F.openviking\u002Flog\u002F*\n\n# Cleanup any temporary files\nrm -f ~\u002F.openviking\u002Fserver.pid\n\necho \"✓ Data deleted successfully\"\n\n# ==========================================\n# STEP 5: COMPLETION\n# ==========================================\necho \"\"\necho \"==========================================\"\necho \"Cleanup Complete!\"\necho \"==========================================\"\necho \"Backup preserved at: ${BACKUP_DIR}\"\necho \"\"\necho \"Next steps:\"\necho \"1. Reconfigure ov.conf if needed\"\necho \"2. Start the server: openviking-server\"\necho \"3. Verify with: curl http:\u002F\u002Flocalhost:1933\u002Fhealth\"\necho \"\"\necho \"To restore from backup:\"\necho \"  tar -xzf ${BACKUP_DIR}\u002Fworkspace_backup.tar.gz -C $(dirname ${WORKSPACE})\"\n```\n\n### Quick Cleanup (for Development Only)\n\n```bash\n# WARNING: Only use in development!\n# No backup created - data loss guaranteed!\n\n# 1. Stop server\npkill -f openviking-server\nsleep 2\npkill -9 -f openviking-server 2>\u002Fdev\u002Fnull || true\n\n# 2. Delete workspace (adjust path as needed)\nrm -rf ~\u002F.openviking\u002Fdata\n\n# 3. Cleanup PID and temp files\nrm -f ~\u002F.openviking\u002Fserver.pid\n\necho \"Quick cleanup complete\"\n```\n\n## Verification and Troubleshooting\n\n### Health Check Verification\n\n```bash\n# Basic health check (always available)\ncurl http:\u002F\u002Flocalhost:1933\u002Fhealth\n# Expected: {\"status\": \"ok\"}\n\n# Readiness check (verifies all components)\ncurl http:\u002F\u002Flocalhost:1933\u002Fready\n# Expected: {\"status\": \"ready\", \"checks\": {\"agfs\": \"ok\", \"vectordb\": \"ok\", \"api_key_manager\": \"ok\"}}\n\n# System status via CLI (~\u002F.openviking\u002Fovcli.conf should be configured)\nov status\n```\n\n### Common Issues and Solutions\n\n#### Issue: Server won't start\n\n**Check:**\n```bash\n# 1. Check if port is in use\nlsof -i :1933\nnetstat -tulpn | grep 1933\n\n# 2. Check log for errors\ntail -10 ~\u002F.openviking\u002Flog\u002Fopenviking-server.log\ntail -100 ~\u002F.openviking\u002Flog\u002Fopenviking.log\n\n\n# 3. Verify config file is valid JSON\npython3 -c 'import json, os; json.load(open(os.path.expanduser(\"~\u002F.openviking\u002Fov.conf\"))); print(\"Config is valid\")'\n\n# 4. Verify virtual environment\nsource ~\u002F.openviking\u002Fov-venv\u002Fbin\u002Factivate\nwhich openviking-server\npip list | grep openviking\n```\n\n**Solution:**\n```bash\n# If port conflict: kill the process or use different port\nlsof -ti :1933 | xargs kill -9 2>\u002Fdev\u002Fnull || true\n\n# Or start on different port\nnohup openviking-server --port 1934 > ~\u002F.openviking\u002Flog\u002Fopenviking-server.log 2>&1 &\n```\n\n#### Issue: API Key Errors\n\n**Check:**\n```bash\n# Verify API keys in config\npython3 -c '\nimport json, os\ncfg = json.load(open(os.path.expanduser(\"~\u002F.openviking\u002Fov.conf\")))\nprint(\"Embedding provider:\", cfg.get(\"embedding\", {}).get(\"dense\", {}).get(\"provider\"))\nprint(\"VLM provider:\", cfg.get(\"vlm\", {}).get(\"provider\"))\nprint(\"API keys set:\", bool(cfg.get(\"embedding\", {}).get(\"dense\", {}).get(\"api_key\")), bool(cfg.get(\"vlm\", {}).get(\"api_key\")))\n'\n```\n\n**Solution:** Verify API keys are correct and have the required permissions. Check network connectivity to the model provider endpoints. Ensure API keys are not expired.\n\n## Prerequisites\n\n- Python 3.10+ installed\n- uv package manager available\n- Sufficient disk space for workspace and log\n- API keys for embedding and VLM models configured\n- Network access to model providers (if using cloud models)\n","# OpenViking Server Operations\n\nThis guide provides standard operating procedures for deploying, managing, and maintaining OpenViking servers in production environments.\n\n## Table of Content\n- Service Configuration\n- Environment Setup with uv\n- Server Startup with nohup\n- Server Shutdown\n- Data Cleanup Procedure\n- Verification and Troubleshooting\n\n## Service Configuration\n\n### Default Paths and Structure\n\nOpenViking uses the following standard directory structure under `~\u002F.openviking\u002F`:\n\n```\n~\u002F.openviking\u002F\n├── ov.conf             # Server configuration (required)\n├── ovcli.conf          # CLI client configuration\n├── ov-venv\u002F            # Virtual environment (created by uv)\n├── log\u002F                # Server log directory\n│   ├── openviking-server.log   # server stdout log\n│   └── openviking.log          # server log\n└── data\u002F               # Workspace data (configured in ov.conf)\n    ├── ...\n    └── ...\n```\n\n### Configuration Files\n\n#### 1. Server Config (`~\u002F.openviking\u002Fov.conf`)\n\nCreate the configuration file with at minimum the following configuration.\nNote 1: Replace the api-key with your own api-key. If you don't have one, ask the user to get one (follow the Volcengine Ark platform guide).\nNote 2: Replace the root_api_key with your own root-api-key. Ask the user to set one — it will be used for authentication when the CLI connects to the server.\n\n```json\n{\n  \"server\": {\n    \"host\": \"0.0.0.0\",\n    \"port\": 1933,\n    \"root_api_key\": \"your-root-api-key\"\n  },\n  \"storage\": {\n    \"workspace\": \"~\u002F.openviking\u002Fdata\u002F\"\n  },\n  \"parsers\": {\n    \"code\": {\n      \"gitlab_domains\": [\"code.byted.org\"],\n      \"azure_devops_domains\": [\"ssh.dev.azure.com\", \"vs-ssh.visualstudio.com\"]\n    }\n  },\n  \"embedding\": {\n    \"dense\": {\n        \"model\": \"doubao-embedding-vision-251215\",\n        \"api_key\": \"your-volcengine-api-key\",\n        \"api_base\": \"https:\u002F\u002Fark.cn-beijing.volces.com\u002Fapi\u002Fv3\",\n        \"dimension\": 1024,\n        \"input\": \"multimodal\",\n        \"provider\": \"volcengine\"\n    }\n  },\n  \"vlm\": {\n    \"model\": \"doubao-seed-1-8-251228\",\n    \"api_key\": \"your-volcengine-api-key\",\n    \"api_base\": \"https:\u002F\u002Fark.cn-beijing.volces.com\u002Fapi\u002Fv3\",\n    \"temperature\": 0.0,\n    \"max_retries\": 2,\n    \"provider\": \"volcengine\",\n    \"thinking\": false\n  },\n  \"log\": {\n    \"level\": \"INFO\",\n    \"output\": \"file\",\n    \"rotation\": true,\n    \"rotation_days\": 3,\n    \"rotation_interval\": \"midnight\"\n  }\n}\n```\n\n#### 2. CLI Config (`~\u002F.openviking\u002Fovcli.conf`)\n\nFor client connections from localhost:\n\n```json\n{\n  \"url\": \"http:\u002F\u002Flocalhost:1933\",\n  \"api_key\": \"your-root-api-key\"\n}\n```\n\nFor remote connections, set the url to the remote server address (for example, the server EIP).\n\n## Environment Setup with uv\n\n### Step 1: Install uv (if not already installed)\n\n```bash\n# macOS\u002FLinux\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# Verify installation\nuv --version\n```\n\n### Step 2: Create Virtual Environment\n\nCreate a dedicated virtual environment at `~\u002F.openviking\u002Fov-venv`:\n\n```bash\n# Create venv with Python 3.10+\ncd ~\u002F.openviking\nuv venv --python 3.12 ov-venv\n```\n\n### Step 3: Activate and Install OpenViking\n\n```bash\n# Activate the virtual environment\nsource ~\u002F.openviking\u002Fov-venv\u002Fbin\u002Factivate\n\n# Install or upgrade to latest openviking\nuv pip install --upgrade openviking --force-reinstall\n\n# Verify installation\nwhich openviking-server\nopenviking-server --version\nopenviking-server --help\n```\n\n### Step 4: Create Log Directory\n\n```bash\nmkdir -p ~\u002F.openviking\u002Flog\n```\n\n## Server Startup with nohup\n\n### Standard Startup Procedure\n\n```bash\n# 1. Activate the virtual environment\nsource ~\u002F.openviking\u002Fov-venv\u002Fbin\u002Factivate\n\n# 2. Ensure log directory exists\nmkdir -p ~\u002F.openviking\u002Flog\n\n# 3. Start server with nohup\nnohup openviking-server \\\n    > ~\u002F.openviking\u002Flog\u002Fopenviking-server.log 2>&1 &\n\n# 4. Save PID for later reference\necho $! > ~\u002F.openviking\u002Fserver.pid\n\n# 5. Verify startup after 10 secs\nsleep 10\ncurl -s http:\u002F\u002Flocalhost:1933\u002Fhealth\n```\n\n### Verify Server is Running\n\n```bash\n# Method 1: Check health endpoint\ncurl http:\u002F\u002Flocalhost:1933\u002Fhealth\n# Expected: {\"status\": \"ok\"}\n\n# Method 2: Check readiness (includes storage checks)\ncurl http:\u002F\u002Flocalhost:1933\u002Fready\n\n# Method 3: Check process\nps aux | grep openviking-server | grep -v grep\n\n# Method 4: Check log output\ntail -10 ~\u002F.openviking\u002Flog\u002Fopenviking-server.log\ntail -50 ~\u002F.openviking\u002Flog\u002Fopenviking.log\n```\n\n## Server Shutdown\n\n### Graceful Shutdown Procedure\n\n```bash\n# 1. Find the server process\nps aux | grep openviking-server | grep -v grep\n\n# 2. Send SIGTERM for graceful shutdown\n# Option A: Using saved PID\nif [ -f ~\u002F.openviking\u002Fserver.pid ]; then\n    kill $(cat ~\u002F.openviking\u002Fserver.pid)\n    rm ~\u002F.openviking\u002Fserver.pid\nfi\n\n# Option B: Using pgrep\npkill -f openviking-server\n\n# 3. Wait for process to stop\nsleep 3\n\n# 4. Verify it stopped\nps aux | grep openviking-server | grep -v grep || echo \"Server stopped successfully\"\n\n# 5. If still running, force kill\nif pgrep -f openviking-server > \u002Fdev\u002Fnull; then\n    echo \"Force killing server...\"\n    pkill -9 -f openviking-server\nfi\n```\n\n## Data Cleanup Procedure\n\n### When to Use This Procedure\n\nPerform full data cleanup in these scenarios:\n1. Version upgrade with incompatible data format\n2. Corrupted or inconsistent data\n3. Need to reset to fresh state\n4. Storage space reclamation\n\n### Standard Cleanup Workflow\n\n**CRITICAL: ALWAYS BACKUP BEFORE DELETING DATA**\n\n```bash\n# ==========================================\n# STEP 1: STOP THE SERVER FIRST\n# ==========================================\necho \"Step 1: Stopping OpenViking Server...\"\nif pgrep -f openviking-server > \u002Fdev\u002Fnull; then\n    pkill -f openviking-server\n    sleep 3\n    if pgrep -f openviking-server > \u002Fdev\u002Fnull; then\n        pkill -9 -f openviking-server\n        sleep 1\n    fi\nfi\n\n# Verify server is stopped\nif pgrep -f openviking-server > \u002Fdev\u002Fnull; then\n    echo \"ERROR: Server still running! Cannot proceed.\"\n    exit 1\nfi\necho \"✓ Server stopped\"\n\n# ==========================================\n# STEP 2: CREATE BACKUP (REQUIRED)\n# ==========================================\necho \"\"\necho \"Step 2: Creating backup...\"\nBACKUP_DATE=$(date +%Y%m%d_%H%M%S)\nBACKUP_DIR=~\u002F.openviking\u002Fbackup_${BACKUP_DATE}\n\nmkdir -p ${BACKUP_DIR}\n\n# Backup config files\ncp ~\u002F.openviking\u002Fov.conf ${BACKUP_DIR}\u002F 2>\u002Fdev\u002Fnull || true\ncp ~\u002F.openviking\u002Fovcli.conf ${BACKUP_DIR}\u002F 2>\u002Fdev\u002Fnull || true\n\n# Backup workspace (if exists)\nWORKSPACE=$(python3 -c '\nimport json\nimport os\nconfig_path = os.path.expanduser(\"~\u002F.openviking\u002Fov.conf\")\nif os.path.exists(config_path):\n    with open(config_path) as f:\n        cfg = json.load(f)\n        ws = cfg.get(\"storage\", {}).get(\"workspace\", \".\u002Fdata\")\n        print(os.path.expanduser(ws))\n' 2>\u002Fdev\u002Fnull || echo \"~\u002F.openviking\u002Fdata\")\n\nif [ -d \"${WORKSPACE}\" ]; then\n    echo \"Backing up workspace: ${WORKSPACE}\"\n    tar -czf ${BACKUP_DIR}\u002Fworkspace_backup.tar.gz -C $(dirname ${WORKSPACE}) $(basename ${WORKSPACE})\nfi\n\n# Backup log\nif [ -d ~\u002F.openviking\u002Flog ]; then\n    cp -r ~\u002F.openviking\u002Flog ${BACKUP_DIR}\u002F 2>\u002Fdev\u002Fnull || true\nfi\n\necho \"✓ Backup created at: ${BACKUP_DIR}\"\nls -lh ${BACKUP_DIR}\u002F\n\n# ==========================================\n# STEP 3: CONFIRM DELETION\n# ==========================================\necho \"\"\necho \"==========================================\"\necho \"WARNING: ABOUT TO DELETE ALL DATA!\"\necho \"==========================================\"\necho \"Workspace to delete: ${WORKSPACE}\"\necho \"Backup location: ${BACKUP_DIR}\"\necho \"\"\nread -p \"Type 'DELETE' to confirm data removal: \" CONFIRM\n\nif [ \"${CONFIRM}\" != \"DELETE\" ]; then\n    echo \"Cleanup cancelled. Backup preserved at ${BACKUP_DIR}\"\n    exit 0\nfi\n\n# ==========================================\n# STEP 4: DELETE DATA\n# ==========================================\necho \"\"\necho \"Step 4: Deleting data...\"\n\n# Delete workspace\nif [ -d \"${WORKSPACE}\" ]; then\n    echo \"Deleting workspace: ${WORKSPACE}\"\n    rm -rf \"${WORKSPACE}\"\nfi\n\n# Optional: Delete old log (uncomment if needed)\n# echo \"Deleting old log...\"\n# rm -rf ~\u002F.openviking\u002Flog\u002F*\n\n# Cleanup any temporary files\nrm -f ~\u002F.openviking\u002Fserver.pid\n\necho \"✓ Data deleted successfully\"\n\n# ==========================================\n# STEP 5: COMPLETION\n# ==========================================\necho \"\"\necho \"==========================================\"\necho \"Cleanup Complete!\"\necho \"==========================================\"\necho \"Backup preserved at: ${BACKUP_DIR}\"\necho \"\"\necho \"Next steps:\"\necho \"1. Reconfigure ov.conf if needed\"\necho \"2. Start the server: openviking-server\"\necho \"3. Verify with: curl http:\u002F\u002Flocalhost:1933\u002Fhealth\"\necho \"\"\necho \"To restore from backup:\"\necho \"  tar -xzf ${BACKUP_DIR}\u002Fworkspace_backup.tar.gz -C $(dirname ${WORKSPACE})\"\n```\n\n### Quick Cleanup (for Development Only)\n\n```bash\n# WARNING: Only use in development!\n# No backup created - data loss guaranteed!\n\n# 1. Stop server\npkill -f openviking-server\nsleep 2\npkill -9 -f openviking-server 2>\u002Fdev\u002Fnull || true\n\n# 2. Delete workspace (adjust path as needed)\nrm -rf ~\u002F.openviking\u002Fdata\n\n# 3. Cleanup PID and temp files\nrm -f ~\u002F.openviking\u002Fserver.pid\n\necho \"Quick cleanup complete\"\n```\n\n## Verification and Troubleshooting\n\n### Health Check Verification\n\n```bash\n# Basic health check (always available)\ncurl http:\u002F\u002Flocalhost:1933\u002Fhealth\n# Expected: {\"status\": \"ok\"}\n\n# Readiness check (verifies all components)\ncurl http:\u002F\u002Flocalhost:1933\u002Fready\n# Expected: {\"status\": \"ready\", \"checks\": {\"agfs\": \"ok\", \"vectordb\": \"ok\", \"api_key_manager\": \"ok\"}}\n\n# System status via CLI (~\u002F.openviking\u002Fovcli.conf should be configured)\nov status\n```\n\n### Common Issues and Solutions\n\n#### Issue: Server won't start\n\n**Check:**\n```bash\n# 1. Check if port is in use\nlsof -i :1933\nnetstat -tulpn | grep 1933\n\n# 2. Check log for errors\ntail -10 ~\u002F.openviking\u002Flog\u002Fopenviking-server.log\ntail -100 ~\u002F.openviking\u002Flog\u002Fopenviking.log\n\n\n# 3. Verify config file is valid JSON\npython3 -c 'import json, os; json.load(open(os.path.expanduser(\"~\u002F.openviking\u002Fov.conf\"))); print(\"Config is valid\")'\n\n# 4. Verify virtual environment\nsource ~\u002F.openviking\u002Fov-venv\u002Fbin\u002Factivate\nwhich openviking-server\npip list | grep openviking\n```\n\n**Solution:**\n```bash\n# If port conflict: kill the process or use different port\nlsof -ti :1933 | xargs kill -9 2>\u002Fdev\u002Fnull || true\n\n# Or start on different port\nnohup openviking-server --port 1934 > ~\u002F.openviking\u002Flog\u002Fopenviking-server.log 2>&1 &\n```\n\n#### Issue: API Key Errors\n\n**Check:**\n```bash\n# Verify API keys in config\npython3 -c '\nimport json, os\ncfg = json.load(open(os.path.expanduser(\"~\u002F.openviking\u002Fov.conf\")))\nprint(\"Embedding provider:\", cfg.get(\"embedding\", {}).get(\"dense\", {}).get(\"provider\"))\nprint(\"VLM provider:\", cfg.get(\"vlm\", {}).get(\"provider\"))\nprint(\"API keys set:\", bool(cfg.get(\"embedding\", {}).get(\"dense\", {}).get(\"api_key\")), bool(cfg.get(\"vlm\", {}).get(\"api_key\")))\n'\n```\n\n**Solution:** Verify API keys are correct and have the required permissions. Check network connectivity to the model provider endpoints. Ensure API keys are not expired.\n\n## Prerequisites\n\n- Python 3.10+ installed\n- uv package manager available\n- Sufficient disk space for workspace and log\n- API keys for embedding and VLM models configured\n- Network access to model providers (if using cloud models)\n",{"name":5,"description":7,"compatibility":24},"OpenViking CLI configured at `~\u002F.openviking\u002Fovcli.conf`","main","89af4b6bd8e57a4af34127bcd3e74beba2960c99","othergithubdemo\u002FOpenViking-main\u002FOpenViking-main\u002Fexamples\u002Fskills\u002Fov-server-operate",0,"https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion","https:\u002F\u002Fgithub.com\u002Fzhangmask","2026-08-12 23:25:19",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add zhangmask\u002FC_AnimeCompanion --skill ov-server-operate",{"tool":38,"command":39},"bunx","bunx skills add zhangmask\u002FC_AnimeCompanion --skill ov-server-operate",{"tool":41,"command":42},"pnpm","pnpm dlx skills add zhangmask\u002FC_AnimeCompanion --skill ov-server-operate","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002FOpenViking-main\u002FOpenViking-main\u002Fexamples\u002Fskills\u002Fov-server-operate\u002FSKILL.md",true,[],[47,55,63,71,79,87],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":51,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M75DWFRG97DMF5XB527G18KQ","mem0","Mem0 Platform SDK for adding persistent memory to AI applications. TRIGGER when: user mentions \"mem0\", \"MemoryClient\", \"memory layer\", \"remember user preferences\", \"persistent context\", \"personalization\", or needs to add long-term memory to chatbots, agents, or AI apps. Covers Python SDK (mem0ai), TypeScript SDK (mem0ai), and framework integrations (LangChain, CrewAI, OpenAI Agents SDK, Pipecat, LlamaIndex, AutoGen, LangGraph). Also covers the open-source self-hosted Memory class. This is the DEFAULT mem0 skill for ambiguous queries. DO NOT TRIGGER when: user asks about CLI commands, terminal usage, or shell scripts (use mem0-cli), or Vercel AI SDK \u002F @mem0\u002Fvercel-ai-provider \u002F createMem0 (use mem0-vercel-ai-sdk).","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":59,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M75DWA6DYJVW82BRA7PGWAWP","mem0-vercel-ai-sdk","Mem0 provider for Vercel AI SDK (@mem0\u002Fvercel-ai-provider). TRIGGER when: user mentions \"vercel ai sdk\", \"@mem0\u002Fvercel-ai-provider\", \"createMem0\", \"retrieveMemories\", \"addMemories\", \"getMemories\", \"searchMemories\", \"mem0 vercel\", \"AI SDK provider\", \"AI SDK memory\", or is using generateText\u002FstreamText with mem0. Also triggers for Next.js apps needing memory-augmented AI. DO NOT TRIGGER when: user asks about direct Python\u002FTS SDK calls without Vercel (use mem0 skill), or CLI terminal commands (use mem0-cli skill).","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0-vercel-ai-sdk\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0-vercel-ai-sdk\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":67,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M75DW1BKX9416VYXSV0MWWKK","mem0-test-integration","Verify a Mem0 integration produced by \u002Fmem0-integrate. Runs in the same workspace on the same branch (loose coupling) — installs dependencies, runs the repo's native test suite, then exercises a real end-to-end smoke flow against the user's API key. Produces a scorecard. TRIGGER when: user has just run \u002Fmem0-integrate and says \"verify\", \"test the integration\", \"run \u002Fmem0-test-integration\", or when a .mem0-integration\u002F directory exists and tests have not been run yet on the current branch. DO NOT TRIGGER when: the user wants to run general project tests (defer to the repo's native test command), or when no prior \u002Fmem0-integrate run exists in the current branch (ask them to run \u002Fmem0-integrate first). This skill ONLY catches compile and runtime bugs by design. Logical integration errors — wrong data stored, wrong time retrieved, wrong user scoping — are on the human reviewer.","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0-test-integration\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0-test-integration\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":75,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M75DVRVCQK3DNHFASD8SD2A2","mem0-oss-to-platform","Plan and then execute a migration of a project from the mem0 open-source \u002F self-hosted SDK (the local `Memory` class) to the mem0 Platform \u002F hosted \u002F managed SDK (the `MemoryClient` class). Use this whenever a developer wants to move, switch, or migrate their mem0 usage off OSS\u002Fself-hosted to the hosted API — e.g. \"migrate my mem0 setup to the platform\", \"switch from self-hosted mem0 to MemoryClient\", \"use my mem0 API key instead of a local Qdrant\", \"move mem0 to the cloud\u002Fhosted\u002Fmanaged service\", or \"replace my local mem0 vector store + embedder config with the platform\". Applies to Python (`from mem0 import Memory` → `from mem0 import MemoryClient`) and TypeScript\u002FJavaScript (`import { Memory } from \"mem0ai\u002Foss\"` → `import MemoryClient from \"mem0ai\"`). Trigger even when the user doesn't say the word \"migrate\" but clearly wants their existing mem0 integration to run against the hosted platform. It first produces a reviewable migration plan, then executes it after the developer approves. Strictly scoped to the mem0 integration — it does not refactor, restructure, or \"improve\" any unrelated code.","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0-oss-to-platform\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0-oss-to-platform\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":83,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M75DVH4QN1KKJ6JWFH0ZEP4K","mem0-integrate","Integrate Mem0 into an existing repository using a goal-driven, TDD pipeline. Detects the repo's language automatically and asks the user to pick between Mem0 Platform (managed) and Mem0 Open Source (self-hosted). Writes failing tests before any implementation. Produces a local feature branch plus `.mem0-integration\u002F` artifacts consumed by the paired verification skill. TRIGGER when: user says \"integrate mem0\", \"add mem0 to this repo\", \"wire mem0 into \u003Crepo>\", or asks how to add memory to an existing project. DO NOT TRIGGER when: the user wants general SDK usage (use skill:mem0), CLI usage (use skill:mem0-cli), or Vercel AI SDK (use skill:mem0-vercel-ai-sdk). After success, invoke skill:mem0-test-integration to verify in the same workspace (loose coupling).","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0-integrate\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0-integrate\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M75DV93TE88NQW790RDN7WRY","mem0-cli","Mem0 CLI -- the command-line interface for mem0 memory operations. TRIGGER when: user mentions \"mem0 cli\", \"mem0 command line\", \"@mem0\u002Fcli\", \"mem0-cli\", \"pip install mem0-cli\", \"npm install -g @mem0\u002Fcli\", or is running mem0 commands in a terminal\u002Fshell (mem0 add, mem0 search, mem0 list, mem0 get, mem0 init, mem0 config, mem0 import). Also triggers when query includes CLI flags like --user-id, --output, --json, --agent, or describes bash\u002Fzsh\u002Fterminal\u002Fshell usage. DO NOT TRIGGER when: user asks about programmatic SDK integration in Python\u002FTS code (use mem0 skill), or Vercel AI SDK provider (use mem0-vercel-ai-sdk skill).","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0-cli\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fzhangmask\u002FC_AnimeCompanion\u002Fblob\u002Fmain\u002Fothergithubdemo\u002Fmem0-main\u002Fmem0-main\u002Fskills\u002Fmem0-cli\u002FSKILL.md",[],[]]