[{"data":1,"prerenderedAt":680},["ShallowReactive",2],{"/open_source/best_practice/common_errors_solutions":3,"surround-/open_source/best_practice/common_errors_solutions":665},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":6,"description":26,"extension":659,"links":6,"meta":660,"navigation":6,"path":661,"seo":662,"stem":663,"__hash__":664},"docs/en/open_source/best_practice/common_errors_solutions.md","Common Errors and Solutions",null,{"type":8,"value":9,"toc":648},"minimark",[10,15,20,148,152,287,291,329,333,417,421,473,477,644],[11,12,14],"h2",{"id":13},"configuration-errors","Configuration Errors",[16,17,19],"h3",{"id":18},"missing-required-fields","Missing Required Fields",[21,22,27],"pre",{"className":23,"code":24,"language":25,"meta":26,"style":26},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# ✅ Always include required fields\nllm_config = {\n    \"backend\": \"openai\",\n    \"config\": {\n        \"api_key\": \"your-api-key\",\n        \"model_name_or_path\": \"gpt-4\"\n    }\n}\n","python","",[28,29,30,39,53,80,94,116,136,142],"code",{"__ignoreMap":26},[31,32,35],"span",{"class":33,"line":34},"line",1,[31,36,38],{"class":37},"sHwdD","# ✅ Always include required fields\n",[31,40,42,46,50],{"class":33,"line":41},2,[31,43,45],{"class":44},"sTEyZ","llm_config ",[31,47,49],{"class":48},"sMK4o","=",[31,51,52],{"class":48}," {\n",[31,54,56,59,63,66,69,72,75,77],{"class":33,"line":55},3,[31,57,58],{"class":48},"    \"",[31,60,62],{"class":61},"sfazB","backend",[31,64,65],{"class":48},"\"",[31,67,68],{"class":48},":",[31,70,71],{"class":48}," \"",[31,73,74],{"class":61},"openai",[31,76,65],{"class":48},[31,78,79],{"class":48},",\n",[31,81,83,85,88,90,92],{"class":33,"line":82},4,[31,84,58],{"class":48},[31,86,87],{"class":61},"config",[31,89,65],{"class":48},[31,91,68],{"class":48},[31,93,52],{"class":48},[31,95,97,100,103,105,107,109,112,114],{"class":33,"line":96},5,[31,98,99],{"class":48},"        \"",[31,101,102],{"class":61},"api_key",[31,104,65],{"class":48},[31,106,68],{"class":48},[31,108,71],{"class":48},[31,110,111],{"class":61},"your-api-key",[31,113,65],{"class":48},[31,115,79],{"class":48},[31,117,119,121,124,126,128,130,133],{"class":33,"line":118},6,[31,120,99],{"class":48},[31,122,123],{"class":61},"model_name_or_path",[31,125,65],{"class":48},[31,127,68],{"class":48},[31,129,71],{"class":48},[31,131,132],{"class":61},"gpt-4",[31,134,135],{"class":48},"\"\n",[31,137,139],{"class":33,"line":138},7,[31,140,141],{"class":48},"    }\n",[31,143,145],{"class":33,"line":144},8,[31,146,147],{"class":48},"}\n",[16,149,151],{"id":150},"backend-mismatch","Backend Mismatch",[21,153,155],{"className":23,"code":154,"language":25,"meta":26,"style":26},"# ✅ KVCache requires HuggingFace backend\nkv_config = {\n    \"backend\": \"kv_cache\",\n    \"config\": {\n        \"extractor_llm\": {\n            \"backend\": \"huggingface\",\n            \"config\": {\n                \"model_name_or_path\": \"Qwen/Qwen3-1.7B\"\n            }\n        }\n    }\n}\n",[28,156,157,162,171,190,202,215,235,247,265,271,277,282],{"__ignoreMap":26},[31,158,159],{"class":33,"line":34},[31,160,161],{"class":37},"# ✅ KVCache requires HuggingFace backend\n",[31,163,164,167,169],{"class":33,"line":41},[31,165,166],{"class":44},"kv_config ",[31,168,49],{"class":48},[31,170,52],{"class":48},[31,172,173,175,177,179,181,183,186,188],{"class":33,"line":55},[31,174,58],{"class":48},[31,176,62],{"class":61},[31,178,65],{"class":48},[31,180,68],{"class":48},[31,182,71],{"class":48},[31,184,185],{"class":61},"kv_cache",[31,187,65],{"class":48},[31,189,79],{"class":48},[31,191,192,194,196,198,200],{"class":33,"line":82},[31,193,58],{"class":48},[31,195,87],{"class":61},[31,197,65],{"class":48},[31,199,68],{"class":48},[31,201,52],{"class":48},[31,203,204,206,209,211,213],{"class":33,"line":96},[31,205,99],{"class":48},[31,207,208],{"class":61},"extractor_llm",[31,210,65],{"class":48},[31,212,68],{"class":48},[31,214,52],{"class":48},[31,216,217,220,222,224,226,228,231,233],{"class":33,"line":118},[31,218,219],{"class":48},"            \"",[31,221,62],{"class":61},[31,223,65],{"class":48},[31,225,68],{"class":48},[31,227,71],{"class":48},[31,229,230],{"class":61},"huggingface",[31,232,65],{"class":48},[31,234,79],{"class":48},[31,236,237,239,241,243,245],{"class":33,"line":138},[31,238,219],{"class":48},[31,240,87],{"class":61},[31,242,65],{"class":48},[31,244,68],{"class":48},[31,246,52],{"class":48},[31,248,249,252,254,256,258,260,263],{"class":33,"line":144},[31,250,251],{"class":48},"                \"",[31,253,123],{"class":61},[31,255,65],{"class":48},[31,257,68],{"class":48},[31,259,71],{"class":48},[31,261,262],{"class":61},"Qwen/Qwen3-1.7B",[31,264,135],{"class":48},[31,266,268],{"class":33,"line":267},9,[31,269,270],{"class":48},"            }\n",[31,272,274],{"class":33,"line":273},10,[31,275,276],{"class":48},"        }\n",[31,278,280],{"class":33,"line":279},11,[31,281,141],{"class":48},[31,283,285],{"class":33,"line":284},12,[31,286,147],{"class":48},[11,288,290],{"id":289},"service-connection-issues","Service Connection Issues",[21,292,296],{"className":293,"code":294,"language":295,"meta":26,"style":26},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Start required services as needed\ndocker run -p 6333:6333 qdrant/qdrant\nollama serve\n","bash",[28,297,298,303,321],{"__ignoreMap":26},[31,299,300],{"class":33,"line":34},[31,301,302],{"class":37},"# Start required services as needed\n",[31,304,305,309,312,315,318],{"class":33,"line":41},[31,306,308],{"class":307},"sBMFI","docker",[31,310,311],{"class":61}," run",[31,313,314],{"class":61}," -p",[31,316,317],{"class":61}," 6333:6333",[31,319,320],{"class":61}," qdrant/qdrant\n",[31,322,323,326],{"class":33,"line":55},[31,324,325],{"class":307},"ollama",[31,327,328],{"class":61}," serve\n",[16,330,332],{"id":331},"memory-loading-failures","Memory Loading Failures",[21,334,336],{"className":23,"code":335,"language":25,"meta":26,"style":26},"try:\n    mem_cube.load(\"memory_dir\")\nexcept Exception:\n    mem_cube = GeneralMemCube(config)\n    mem_cube.dump(\"memory_dir\")\n",[28,337,338,347,372,382,398],{"__ignoreMap":26},[31,339,340,344],{"class":33,"line":34},[31,341,343],{"class":342},"s7zQu","try",[31,345,346],{"class":48},":\n",[31,348,349,352,355,359,362,364,367,369],{"class":33,"line":41},[31,350,351],{"class":44},"    mem_cube",[31,353,354],{"class":48},".",[31,356,358],{"class":357},"s2Zo4","load",[31,360,361],{"class":48},"(",[31,363,65],{"class":48},[31,365,366],{"class":61},"memory_dir",[31,368,65],{"class":48},[31,370,371],{"class":48},")\n",[31,373,374,377,380],{"class":33,"line":55},[31,375,376],{"class":342},"except",[31,378,379],{"class":307}," Exception",[31,381,346],{"class":48},[31,383,384,387,389,392,394,396],{"class":33,"line":82},[31,385,386],{"class":44},"    mem_cube ",[31,388,49],{"class":48},[31,390,391],{"class":357}," GeneralMemCube",[31,393,361],{"class":48},[31,395,87],{"class":357},[31,397,371],{"class":48},[31,399,400,402,404,407,409,411,413,415],{"class":33,"line":96},[31,401,351],{"class":44},[31,403,354],{"class":48},[31,405,406],{"class":357},"dump",[31,408,361],{"class":48},[31,410,65],{"class":48},[31,412,366],{"class":61},[31,414,65],{"class":48},[31,416,371],{"class":48},[16,418,420],{"id":419},"gpu-out-of-memory","GPU Out Of Memory",[21,422,424],{"className":23,"code":423,"language":25,"meta":26,"style":26},"import os\nos.environ[\"CUDA_VISIBLE_DEVICES\"] = \"0\"\n# Use smaller models if GPU memory is limited: Qwen/Qwen3-0.6B\n",[28,425,426,434,468],{"__ignoreMap":26},[31,427,428,431],{"class":33,"line":34},[31,429,430],{"class":342},"import",[31,432,433],{"class":44}," os\n",[31,435,436,439,441,445,448,450,453,455,458,461,463,466],{"class":33,"line":41},[31,437,438],{"class":44},"os",[31,440,354],{"class":48},[31,442,444],{"class":443},"swJcz","environ",[31,446,447],{"class":48},"[",[31,449,65],{"class":48},[31,451,452],{"class":61},"CUDA_VISIBLE_DEVICES",[31,454,65],{"class":48},[31,456,457],{"class":48},"]",[31,459,460],{"class":48}," =",[31,462,71],{"class":48},[31,464,465],{"class":61},"0",[31,467,135],{"class":48},[31,469,470],{"class":33,"line":55},[31,471,472],{"class":37},"# Use smaller models if GPU memory is limited: Qwen/Qwen3-0.6B\n",[11,474,476],{"id":475},"user-management","User Management",[21,478,480],{"className":23,"code":479,"language":25,"meta":26,"style":26},"# Register user first\nmos.register_mem_cube(cube_path=\"path\", user_id=\"user_id\", cube_id=\"cube_id\")\n\n# Check if user exists\ntry:\n    user_id = mos.create_user(user_name=\"john\", role=UserRole.USER)\nexcept ValueError:\n    user = mos.user_manager.get_user_by_name(\"john\")\n",[28,481,482,487,543,549,554,560,606,615],{"__ignoreMap":26},[31,483,484],{"class":33,"line":34},[31,485,486],{"class":37},"# Register user first\n",[31,488,489,492,494,497,499,503,505,507,510,512,515,518,520,522,525,527,529,532,534,536,539,541],{"class":33,"line":41},[31,490,491],{"class":44},"mos",[31,493,354],{"class":48},[31,495,496],{"class":357},"register_mem_cube",[31,498,361],{"class":48},[31,500,502],{"class":501},"sHdIc","cube_path",[31,504,49],{"class":48},[31,506,65],{"class":48},[31,508,509],{"class":61},"path",[31,511,65],{"class":48},[31,513,514],{"class":48},",",[31,516,517],{"class":501}," user_id",[31,519,49],{"class":48},[31,521,65],{"class":48},[31,523,524],{"class":61},"user_id",[31,526,65],{"class":48},[31,528,514],{"class":48},[31,530,531],{"class":501}," cube_id",[31,533,49],{"class":48},[31,535,65],{"class":48},[31,537,538],{"class":61},"cube_id",[31,540,65],{"class":48},[31,542,371],{"class":48},[31,544,545],{"class":33,"line":55},[31,546,548],{"emptyLinePlaceholder":547},true,"\n",[31,550,551],{"class":33,"line":82},[31,552,553],{"class":37},"# Check if user exists\n",[31,555,556,558],{"class":33,"line":96},[31,557,343],{"class":342},[31,559,346],{"class":48},[31,561,562,565,567,570,572,575,577,580,582,584,587,589,591,594,596,599,601,604],{"class":33,"line":118},[31,563,564],{"class":44},"    user_id ",[31,566,49],{"class":48},[31,568,569],{"class":44}," mos",[31,571,354],{"class":48},[31,573,574],{"class":357},"create_user",[31,576,361],{"class":48},[31,578,579],{"class":501},"user_name",[31,581,49],{"class":48},[31,583,65],{"class":48},[31,585,586],{"class":61},"john",[31,588,65],{"class":48},[31,590,514],{"class":48},[31,592,593],{"class":501}," role",[31,595,49],{"class":48},[31,597,598],{"class":357},"UserRole",[31,600,354],{"class":48},[31,602,603],{"class":443},"USER",[31,605,371],{"class":48},[31,607,608,610,613],{"class":33,"line":138},[31,609,376],{"class":342},[31,611,612],{"class":307}," ValueError",[31,614,346],{"class":48},[31,616,617,620,622,624,626,629,631,634,636,638,640,642],{"class":33,"line":144},[31,618,619],{"class":44},"    user ",[31,621,49],{"class":48},[31,623,569],{"class":44},[31,625,354],{"class":48},[31,627,628],{"class":443},"user_manager",[31,630,354],{"class":48},[31,632,633],{"class":357},"get_user_by_name",[31,635,361],{"class":48},[31,637,65],{"class":48},[31,639,586],{"class":61},[31,641,65],{"class":48},[31,643,371],{"class":48},[645,646,647],"style",{},"html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}",{"title":26,"searchDepth":41,"depth":41,"links":649},[650,654,658],{"id":13,"depth":41,"text":14,"children":651},[652,653],{"id":18,"depth":55,"text":19},{"id":150,"depth":55,"text":151},{"id":289,"depth":41,"text":290,"children":655},[656,657],{"id":331,"depth":55,"text":332},{"id":419,"depth":55,"text":420},{"id":475,"depth":41,"text":476},"md",{},"/en/open_source/best_practice/common_errors_solutions",{"title":5,"description":26},"en/open_source/best_practice/common_errors_solutions","YDc9BnOumXXfxLF6N2pAYcjQLWanzjd09refYAwuahQ",[666,674],{"title":667,"path":668,"stem":669,"icon":670,"framework":6,"module":6,"class":671,"target":-1,"active":672,"defaultOpen":672,"children":-1,"description":673},"Network Environment Adaptation","/open_source/best_practice/network_workarounds","open_source/best_practice/network_workarounds","i-ri-wifi-line",[],false,"The following are some solutions to network issues that may be encountered during development.",{"title":675,"path":676,"stem":677,"icon":678,"framework":6,"module":6,"class":679,"target":-1,"active":672,"defaultOpen":672,"children":-1,"description":-1},"Configuring Memos MCP in Coze Space","/open_source/best_practice/mcp_for_cozespace_and_tools","open_source/best_practice/mcp_for_cozespace_and_tools","i-ri-tools-line",[],1770372089344]