From 6132968324779299bbd60b22a41fd41e9efd6c1f Mon Sep 17 00:00:00 2001 From: Xingyao Wang Date: Mon, 2 Jun 2025 17:12:10 -0400 Subject: [PATCH] docs: migrate all docs from All-Hands-AI/docs to OpenHands repo (#8848) --- .github/workflows/deploy-docs.yml | 72 - docs/.gitignore | 21 - docs/DOC_STYLE_GUIDE.md | 4 +- docs/README.md | 55 - docs/babel.config.js | 3 - docs/docs.json | 197 + docs/docusaurus.config.ts | 118 - docs/favicon.svg | 19 + docs/generate-swagger-ui.js | 102 - docs/i18n/fr/code.json | 427 - .../options.json | 14 - .../current.json | 210 - .../current/python/python.md | 5 - .../current/python/sidebar.json | 5 - .../current/usage/about.md | 25 - .../current/usage/agents.md | 23 - .../current/usage/architecture.mdx | 50 - .../current/usage/architecture/backend.mdx | 54 - .../current/usage/architecture/runtime.md | 128 - .../current/usage/cloud/cloud-api.md | 177 - .../usage/cloud/cloud-issue-resolver.md | 56 - .../current/usage/cloud/cloud-ui.md | 29 - .../usage/cloud/github-installation.md | 57 - .../usage/cloud/gitlab-installation.md | 50 - .../current/usage/cloud/openhands-cloud.md | 24 - .../current/usage/configuration-options.md | 395 - .../current/usage/custom_sandbox_guide.md | 81 - .../current/usage/customization/repository.md | 23 - .../current/usage/feedback.md | 38 - .../current/usage/getting-started.mdx | 99 - .../current/usage/how-to/cli-mode.md | 55 - .../usage/how-to/custom-sandbox-guide.md | 95 - .../current/usage/how-to/debugging.md | 71 - .../usage/how-to/development-overview.md | 74 - .../usage/how-to/evaluation-harness.md | 278 - .../current/usage/how-to/github-action.md | 51 - .../current/usage/how-to/gui-mode.md | 142 - .../current/usage/how-to/headless-mode.md | 59 - .../usage/how-to/persist-session-data.md | 18 - .../current/usage/installation.mdx | 121 - .../current/usage/intro.mdx | 109 - .../current/usage/key-features.md | 29 - .../current/usage/llms/azure-llms.md | 41 - .../current/usage/llms/azureLLMs.md | 37 - .../current/usage/llms/custom-llm-configs.md | 136 - .../current/usage/llms/google-llms.md | 29 - .../current/usage/llms/googleLLMs.md | 28 - .../current/usage/llms/groq.md | 22 - .../current/usage/llms/litellm-proxy.md | 20 - .../current/usage/llms/llms.md | 92 - .../current/usage/llms/local-llms.md | 83 - .../current/usage/llms/localLLMs.md | 141 - .../current/usage/llms/openai-llms.md | 25 - .../current/usage/llms/openrouter.md | 12 - .../current/usage/mcp.md | 96 - .../current/usage/prompting-best-practices.md | 43 - .../current/usage/prompting/customization.md | 66 - .../usage/prompting/microagents-keyword.md | 36 - .../usage/prompting/microagents-overview.md | 40 - .../usage/prompting/microagents-public.md | 50 - .../usage/prompting/microagents-repo.md | 31 - .../current/usage/prompting/microagents.md | 215 - .../prompting/prompting-best-practices.md | 37 - .../current/usage/runtimes-index.md | 25 - .../current/usage/runtimes.md | 8 - .../current/usage/runtimes/daytona.md | 32 - .../current/usage/runtimes/docker.md | 129 - .../current/usage/runtimes/local.md | 74 - .../current/usage/runtimes/modal.md | 13 - .../current/usage/runtimes/remote.md | 9 - .../usage/troubleshooting/troubleshooting.md | 68 - .../current/usage/upgrade-guide.md | 72 - .../fr/docusaurus-theme-classic/navbar.json | 26 - docs/i18n/ja/code.json | 427 - .../options.json | 14 - .../current.json | 210 - .../current/python/python.md | 88 - .../current/python/sidebar.json | 5 - .../current/usage/about.md | 25 - .../current/usage/agents.md | 23 - .../current/usage/architecture.mdx | 50 - .../current/usage/architecture/backend.mdx | 52 - .../current/usage/architecture/runtime.md | 127 - .../current/usage/cloud/cloud-api.md | 177 - .../usage/cloud/cloud-issue-resolver.md | 56 - .../current/usage/cloud/cloud-ui.md | 29 - .../usage/cloud/github-installation.md | 57 - .../usage/cloud/gitlab-installation.md | 50 - .../current/usage/cloud/openhands-cloud.md | 24 - .../current/usage/configuration-options.md | 342 - .../current/usage/custom_sandbox_guide.md | 81 - .../current/usage/customization/repository.md | 21 - .../current/usage/feedback.md | 39 - .../current/usage/getting-started.mdx | 93 - .../current/usage/how-to/cli-mode.md | 54 - .../usage/how-to/custom-sandbox-guide.md | 101 - .../current/usage/how-to/debugging.md | 71 - .../usage/how-to/development-overview.md | 74 - .../usage/how-to/evaluation-harness.md | 278 - .../current/usage/how-to/github-action.md | 51 - .../current/usage/how-to/gui-mode.md | 141 - .../current/usage/how-to/headless-mode.md | 58 - .../usage/how-to/persist-session-data.md | 18 - .../current/usage/installation.mdx | 120 - .../current/usage/intro.mdx | 109 - .../current/usage/key-features.md | 29 - .../current/usage/llms.md | 82 - .../current/usage/llms/azure-llms.md | 38 - .../current/usage/llms/azureLLMs.md | 37 - .../current/usage/llms/custom-llm-configs.md | 136 - .../current/usage/llms/google-llms.md | 29 - .../current/usage/llms/googleLLMs.md | 28 - .../current/usage/llms/groq.md | 19 - .../current/usage/llms/litellm-proxy.md | 20 - .../current/usage/llms/llms.md | 92 - .../current/usage/llms/local-llms.md | 83 - .../current/usage/llms/localLLMs.md | 140 - .../current/usage/llms/openai-llms.md | 25 - .../current/usage/llms/openrouter.md | 12 - .../current/usage/mcp.md | 96 - .../current/usage/prompting-best-practices.md | 41 - .../current/usage/prompting/customization.md | 64 - .../usage/prompting/microagents-keyword.md | 36 - .../usage/prompting/microagents-overview.md | 39 - .../usage/prompting/microagents-public.md | 50 - .../usage/prompting/microagents-repo.md | 31 - .../current/usage/prompting/microagents.md | 213 - .../prompting/prompting-best-practices.md | 37 - .../current/usage/runtimes-index.md | 25 - .../current/usage/runtimes.md | 8 - .../current/usage/runtimes/daytona.md | 32 - .../current/usage/runtimes/docker.md | 123 - .../current/usage/runtimes/local.md | 72 - .../current/usage/runtimes/modal.md | 13 - .../current/usage/runtimes/remote.md | 7 - .../usage/troubleshooting/troubleshooting.md | 68 - .../current/usage/upgrade-guide.md | 65 - .../ja/docusaurus-theme-classic/navbar.json | 34 - docs/i18n/pt-BR/code.json | 53 - .../options.json | 14 - .../current.json | 210 - .../current/python/python.md | 3 - .../current/python/sidebar.json | 5 - .../current/usage/about.md | 25 - .../current/usage/agents.md | 24 - .../current/usage/architecture/backend.mdx | 54 - .../current/usage/architecture/runtime.md | 134 - .../current/usage/cloud/cloud-api.md | 177 - .../usage/cloud/cloud-issue-resolver.md | 56 - .../current/usage/cloud/cloud-ui.md | 29 - .../usage/cloud/github-installation.md | 57 - .../usage/cloud/gitlab-installation.md | 50 - .../current/usage/cloud/openhands-cloud.md | 24 - .../current/usage/configuration-options.md | 382 - .../current/usage/customization/repository.md | 23 - .../current/usage/feedback.md | 50 - .../current/usage/getting-started.mdx | 99 - .../current/usage/how-to/cli-mode.md | 56 - .../usage/how-to/custom-sandbox-guide.md | 102 - .../current/usage/how-to/debugging.md | 71 - .../usage/how-to/development-overview.md | 74 - .../usage/how-to/evaluation-harness.md | 278 - .../current/usage/how-to/github-action.md | 51 - .../current/usage/how-to/gui-mode.md | 142 - .../current/usage/how-to/headless-mode.md | 60 - .../current/usage/installation.mdx | 121 - .../current/usage/key-features.md | 29 - .../current/usage/llms/azure-llms.md | 41 - .../current/usage/llms/custom-llm-configs.md | 136 - .../current/usage/llms/google-llms.md | 29 - .../current/usage/llms/groq.md | 24 - .../current/usage/llms/litellm-proxy.md | 20 - .../current/usage/llms/llms.md | 91 - .../current/usage/llms/local-llms.md | 83 - .../current/usage/llms/openai-llms.md | 25 - .../current/usage/llms/openrouter.md | 12 - .../current/usage/mcp.md | 96 - .../usage/prompting/microagents-keyword.md | 36 - .../usage/prompting/microagents-overview.md | 40 - .../usage/prompting/microagents-public.md | 50 - .../usage/prompting/microagents-repo.md | 31 - .../prompting/prompting-best-practices.md | 38 - .../current/usage/runtimes-index.md | 26 - .../current/usage/runtimes.md | 8 - .../current/usage/runtimes/daytona.md | 32 - .../current/usage/runtimes/docker.md | 129 - .../current/usage/runtimes/local.md | 74 - .../current/usage/runtimes/modal.md | 13 - .../current/usage/runtimes/remote.md | 9 - .../usage/troubleshooting/troubleshooting.md | 68 - docs/i18n/zh-Hans/code.json | 427 - .../options.json | 14 - .../current.json | 210 - .../current/python/python.md | 3 - .../current/python/sidebar.json | 5 - .../current/usage/about.md | 25 - .../current/usage/agents.md | 23 - .../current/usage/architecture.mdx | 49 - .../current/usage/architecture/backend.mdx | 53 - .../current/usage/architecture/runtime.md | 126 - .../current/usage/cloud/cloud-api.md | 177 - .../usage/cloud/cloud-issue-resolver.md | 56 - .../current/usage/cloud/cloud-ui.md | 29 - .../usage/cloud/github-installation.md | 57 - .../usage/cloud/gitlab-installation.md | 50 - .../current/usage/cloud/openhands-cloud.md | 24 - .../current/usage/configuration-options.md | 360 - .../current/usage/custom_sandbox_guide.md | 100 - .../current/usage/customization/repository.md | 21 - .../current/usage/feedback.md | 39 - .../current/usage/getting-started.mdx | 90 - .../current/usage/how-to/cli-mode.md | 54 - .../usage/how-to/custom-sandbox-guide.md | 95 - .../current/usage/how-to/debugging.md | 71 - .../usage/how-to/development-overview.md | 74 - .../usage/how-to/evaluation-harness.md | 278 - .../current/usage/how-to/github-action.md | 51 - .../current/usage/how-to/gui-mode.md | 141 - .../current/usage/how-to/headless-mode.md | 58 - .../usage/how-to/persist-session-data.md | 17 - .../current/usage/installation.mdx | 119 - .../current/usage/intro.mdx | 109 - .../current/usage/key-features.md | 29 - .../current/usage/llms/azure-llms.md | 38 - .../current/usage/llms/azureLLMs.md | 37 - .../current/usage/llms/custom-llm-configs.md | 136 - .../current/usage/llms/google-llms.md | 29 - .../current/usage/llms/googleLLMs.md | 28 - .../current/usage/llms/groq.md | 19 - .../current/usage/llms/litellm-proxy.md | 20 - .../current/usage/llms/llms.md | 82 - .../current/usage/llms/local-llms.md | 83 - .../current/usage/llms/localLLMs.md | 140 - .../current/usage/llms/openai-llms.md | 25 - .../current/usage/llms/openrouter.md | 12 - .../current/usage/mcp.md | 96 - .../current/usage/prompting-best-practices.md | 43 - .../current/usage/prompting/customization.md | 64 - .../usage/prompting/microagents-keyword.md | 36 - .../usage/prompting/microagents-overview.md | 38 - .../usage/prompting/microagents-public.md | 50 - .../usage/prompting/microagents-repo.md | 31 - .../current/usage/prompting/microagents.md | 213 - .../prompting/prompting-best-practices.md | 37 - .../current/usage/runtimes-index.md | 25 - .../current/usage/runtimes.md | 8 - .../current/usage/runtimes/daytona.md | 32 - .../current/usage/runtimes/docker.md | 124 - .../current/usage/runtimes/local.md | 73 - .../current/usage/runtimes/modal.md | 13 - .../current/usage/runtimes/remote.md | 7 - .../usage/troubleshooting/troubleshooting.md | 68 - .../current/usage/upgrade-guide.md | 62 - .../docusaurus-theme-classic/navbar.json | 26 - docs/index.mdx | 16 + docs/logo-square.png | Bin 0 -> 1189506 bytes docs/logo/dark.svg | 29 + docs/logo/light.svg | 29 + docs/modules/python/python.md | 3 - docs/modules/python/sidebar.json | 5 - docs/modules/usage/cloud/openhands-cloud.mdx | 65 - docs/modules/usage/runtimes-index.md | 26 - docs/modules/usage/runtimes.md | 8 - docs/modules/usage/windows-without-wsl.md | 195 - docs/{static => }/openapi.json | 0 docs/package-lock.json | 20082 ---------------- docs/package.json | 58 - docs/plugins/tailwind-config.cjs | 13 - docs/sidebars.ts | 311 - docs/src/components/CustomFooter.tsx | 33 - docs/src/components/Demo/Demo.tsx | 21 - docs/src/components/Demo/index.module.css | 6 - .../HomepageHeader/HomepageHeader.tsx | 60 - docs/src/css/custom.css | 33 - docs/src/css/footer.css | 72 - docs/src/css/homepageHeader.css | 46 - docs/src/pages/_footer.tsx | 6 - docs/src/pages/index.tsx | 52 - docs/src/theme/Layout/index.tsx | 12 - docs/static/.nojekyll | 0 docs/static/README.md | 15 - docs/static/img/cloud/add-repo.png | Bin 18879 -> 0 bytes docs/static/img/cloud/issue-resolver.png | Bin 75485 -> 0 bytes docs/translation_cache.json | 14 - docs/translation_updater.py | 144 - docs/tsconfig.json | 7 - .../usage/about.md => usage/about.mdx} | 6 +- .../usage/agents.md => usage/agents.mdx} | 4 +- .../usage/architecture/backend.mdx | 12 +- .../architecture/runtime.mdx} | 4 +- .../cloud/cloud-api.mdx} | 11 +- .../cloud/cloud-issue-resolver.mdx} | 31 +- .../cloud-ui.md => usage/cloud/cloud-ui.mdx} | 6 +- .../cloud/github-installation.mdx} | 9 +- .../cloud/gitlab-installation.mdx} | 7 +- .../cloud/openhands-cloud.mdx} | 5 +- .../configuration-options.mdx} | 26 +- .../usage/feedback.md => usage/feedback.mdx} | 0 docs/{modules => }/usage/getting-started.mdx | 9 +- .../cli-mode.md => usage/how-to/cli-mode.mdx} | 16 +- .../how-to/custom-sandbox-guide.mdx} | 12 +- .../how-to/debugging.mdx} | 4 +- .../how-to/development-overview.mdx} | 7 +- .../how-to/evaluation-harness.mdx} | 4 +- .../how-to/github-action.mdx} | 9 +- .../gui-mode.md => usage/how-to/gui-mode.mdx} | 7 +- .../how-to/headless-mode.mdx} | 14 +- .../how-to/websocket-connection.mdx} | 6 +- docs/{modules => }/usage/installation.mdx | 105 +- .../key-features.mdx} | 7 +- .../llms/azure-llms.mdx} | 12 +- .../llms/custom-llm-configs.mdx} | 11 +- .../llms/google-llms.mdx} | 10 +- .../llms/groq.md => usage/llms/groq.mdx} | 8 +- .../llms/litellm-proxy.mdx} | 7 +- .../llms/llms.md => usage/llms/llms.mdx} | 33 +- .../llms/local-llms.mdx} | 28 +- .../llms/openai-llms.mdx} | 8 +- .../llms/openrouter.mdx} | 8 +- .../llms/screenshots/1_select_power_user.png | Bin .../usage/llms/screenshots/2_select_model.png | Bin .../llms/screenshots/3_select_devstral.png | Bin .../llms/screenshots/4_set_context_window.png | Bin .../usage/llms/screenshots/5_copy_url.png | Bin .../screenshots/6_copy_to_get_model_name.png | Bin docs/{modules/usage/mcp.md => usage/mcp.mdx} | 10 +- .../prompting/microagents-keyword.mdx} | 10 +- .../prompting/microagents-org.mdx} | 9 +- .../prompting/microagents-overview.mdx} | 12 +- .../prompting/microagents-public.mdx} | 10 +- .../prompting/microagents-repo.mdx} | 9 +- .../prompting/prompting-best-practices.mdx} | 8 +- .../prompting/repository.mdx} | 8 +- .../daytona.md => usage/runtimes/daytona.mdx} | 6 +- .../docker.md => usage/runtimes/docker.mdx} | 5 +- docs/usage/runtimes/e2b.mdx | 38 + .../local.md => usage/runtimes/local.mdx} | 12 +- .../modal.md => usage/runtimes/modal.mdx} | 5 +- docs/usage/runtimes/overview.mdx | 26 + .../remote.md => usage/runtimes/remote.mdx} | 10 +- docs/usage/runtimes/runloop.mdx | 31 + .../troubleshooting/troubleshooting.mdx} | 8 +- 342 files changed, 676 insertions(+), 39929 deletions(-) delete mode 100644 .github/workflows/deploy-docs.yml delete mode 100644 docs/.gitignore delete mode 100644 docs/README.md delete mode 100644 docs/babel.config.js create mode 100644 docs/docs.json delete mode 100644 docs/docusaurus.config.ts create mode 100644 docs/favicon.svg delete mode 100644 docs/generate-swagger-ui.js delete mode 100644 docs/i18n/fr/code.json delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-blog/options.json delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current.json delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/python/python.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/python/sidebar.json delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/about.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/agents.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture.mdx delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture/backend.mdx delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture/runtime.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-api.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-issue-resolver.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-ui.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/github-installation.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/gitlab-installation.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/openhands-cloud.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/configuration-options.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/custom_sandbox_guide.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/customization/repository.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/feedback.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/getting-started.mdx delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/cli-mode.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/custom-sandbox-guide.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/debugging.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/development-overview.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/evaluation-harness.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/github-action.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/gui-mode.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/headless-mode.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/persist-session-data.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/installation.mdx delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/intro.mdx delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/key-features.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/azure-llms.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/azureLLMs.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/custom-llm-configs.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/google-llms.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/googleLLMs.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/groq.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/litellm-proxy.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/llms.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/local-llms.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/localLLMs.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/openai-llms.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/llms/openrouter.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/mcp.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/prompting-best-practices.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/prompting/customization.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/prompting/microagents-keyword.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/prompting/microagents-overview.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/prompting/microagents-public.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/prompting/microagents-repo.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/prompting/microagents.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/prompting/prompting-best-practices.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/runtimes-index.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/runtimes.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/runtimes/daytona.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/runtimes/docker.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/runtimes/local.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/runtimes/modal.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/runtimes/remote.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/troubleshooting/troubleshooting.md delete mode 100644 docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/upgrade-guide.md delete mode 100644 docs/i18n/fr/docusaurus-theme-classic/navbar.json delete mode 100644 docs/i18n/ja/code.json delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-blog/options.json delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current.json delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/python/python.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/python/sidebar.json delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/about.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/agents.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/architecture.mdx delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/architecture/backend.mdx delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/architecture/runtime.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/cloud/cloud-api.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/cloud/cloud-issue-resolver.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/cloud/cloud-ui.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/cloud/github-installation.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/cloud/gitlab-installation.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/cloud/openhands-cloud.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/configuration-options.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/custom_sandbox_guide.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/customization/repository.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/feedback.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/getting-started.mdx delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/how-to/cli-mode.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/how-to/custom-sandbox-guide.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/how-to/debugging.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/how-to/development-overview.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/how-to/evaluation-harness.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/how-to/github-action.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/how-to/gui-mode.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/how-to/headless-mode.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/how-to/persist-session-data.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/installation.mdx delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/intro.mdx delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/key-features.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/azure-llms.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/azureLLMs.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/custom-llm-configs.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/google-llms.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/googleLLMs.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/groq.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/litellm-proxy.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/llms.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/local-llms.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/localLLMs.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/openai-llms.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/llms/openrouter.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/mcp.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/prompting-best-practices.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/prompting/customization.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/prompting/microagents-keyword.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/prompting/microagents-overview.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/prompting/microagents-public.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/prompting/microagents-repo.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/prompting/microagents.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/prompting/prompting-best-practices.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/runtimes-index.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/runtimes.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/runtimes/daytona.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/runtimes/docker.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/runtimes/local.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/runtimes/modal.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/runtimes/remote.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/troubleshooting/troubleshooting.md delete mode 100644 docs/i18n/ja/docusaurus-plugin-content-docs/current/usage/upgrade-guide.md delete mode 100644 docs/i18n/ja/docusaurus-theme-classic/navbar.json delete mode 100644 docs/i18n/pt-BR/code.json delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-blog/options.json delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current.json delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/python/python.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/python/sidebar.json delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/about.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/agents.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/architecture/backend.mdx delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/architecture/runtime.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/cloud/cloud-api.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/cloud/cloud-issue-resolver.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/cloud/cloud-ui.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/cloud/github-installation.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/cloud/gitlab-installation.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/cloud/openhands-cloud.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/configuration-options.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/customization/repository.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/feedback.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/getting-started.mdx delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/how-to/cli-mode.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/how-to/custom-sandbox-guide.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/how-to/debugging.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/how-to/development-overview.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/how-to/evaluation-harness.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/how-to/github-action.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/how-to/gui-mode.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/how-to/headless-mode.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/installation.mdx delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/key-features.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/llms/azure-llms.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/llms/custom-llm-configs.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/llms/google-llms.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/llms/groq.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/llms/litellm-proxy.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/llms/llms.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/llms/local-llms.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/llms/openai-llms.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/llms/openrouter.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/mcp.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/prompting/microagents-keyword.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/prompting/microagents-overview.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/prompting/microagents-public.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/prompting/microagents-repo.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/prompting/prompting-best-practices.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/runtimes-index.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/runtimes.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/runtimes/daytona.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/runtimes/docker.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/runtimes/local.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/runtimes/modal.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/runtimes/remote.md delete mode 100644 docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/usage/troubleshooting/troubleshooting.md delete mode 100644 docs/i18n/zh-Hans/code.json delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-blog/options.json delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current.json delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/python/python.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/python/sidebar.json delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/about.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/agents.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/architecture.mdx delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/architecture/backend.mdx delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/architecture/runtime.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/cloud/cloud-api.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/cloud/cloud-issue-resolver.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/cloud/cloud-ui.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/cloud/github-installation.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/cloud/gitlab-installation.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/cloud/openhands-cloud.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/configuration-options.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/custom_sandbox_guide.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/customization/repository.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/feedback.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/getting-started.mdx delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/cli-mode.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/custom-sandbox-guide.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/debugging.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/development-overview.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/evaluation-harness.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/github-action.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/gui-mode.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/headless-mode.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/persist-session-data.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/installation.mdx delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/intro.mdx delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/key-features.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/azure-llms.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/azureLLMs.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/custom-llm-configs.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/google-llms.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/googleLLMs.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/groq.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/litellm-proxy.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/llms.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/local-llms.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/localLLMs.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/openai-llms.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/llms/openrouter.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/mcp.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/prompting-best-practices.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/prompting/customization.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/prompting/microagents-keyword.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/prompting/microagents-overview.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/prompting/microagents-public.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/prompting/microagents-repo.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/prompting/microagents.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/prompting/prompting-best-practices.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/runtimes-index.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/runtimes.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/runtimes/daytona.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/runtimes/docker.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/runtimes/local.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/runtimes/modal.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/runtimes/remote.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/troubleshooting/troubleshooting.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/upgrade-guide.md delete mode 100644 docs/i18n/zh-Hans/docusaurus-theme-classic/navbar.json create mode 100644 docs/index.mdx create mode 100644 docs/logo-square.png create mode 100644 docs/logo/dark.svg create mode 100644 docs/logo/light.svg delete mode 100644 docs/modules/python/python.md delete mode 100644 docs/modules/python/sidebar.json delete mode 100644 docs/modules/usage/cloud/openhands-cloud.mdx delete mode 100644 docs/modules/usage/runtimes-index.md delete mode 100644 docs/modules/usage/runtimes.md delete mode 100644 docs/modules/usage/windows-without-wsl.md rename docs/{static => }/openapi.json (100%) delete mode 100644 docs/package-lock.json delete mode 100644 docs/package.json delete mode 100644 docs/plugins/tailwind-config.cjs delete mode 100644 docs/sidebars.ts delete mode 100644 docs/src/components/CustomFooter.tsx delete mode 100644 docs/src/components/Demo/Demo.tsx delete mode 100644 docs/src/components/Demo/index.module.css delete mode 100644 docs/src/components/HomepageHeader/HomepageHeader.tsx delete mode 100644 docs/src/css/custom.css delete mode 100644 docs/src/css/footer.css delete mode 100644 docs/src/css/homepageHeader.css delete mode 100644 docs/src/pages/_footer.tsx delete mode 100644 docs/src/pages/index.tsx delete mode 100644 docs/src/theme/Layout/index.tsx delete mode 100644 docs/static/.nojekyll delete mode 100644 docs/static/README.md delete mode 100644 docs/static/img/cloud/add-repo.png delete mode 100644 docs/static/img/cloud/issue-resolver.png delete mode 100644 docs/translation_cache.json delete mode 100644 docs/translation_updater.py delete mode 100644 docs/tsconfig.json rename docs/{modules/usage/about.md => usage/about.mdx} (91%) rename docs/{modules/usage/agents.md => usage/agents.mdx} (96%) rename docs/{modules => }/usage/architecture/backend.mdx (91%) rename docs/{modules/usage/architecture/runtime.md => usage/architecture/runtime.mdx} (99%) rename docs/{modules/usage/cloud/cloud-api.md => usage/cloud/cloud-api.mdx} (93%) rename docs/{modules/usage/cloud/cloud-issue-resolver.md => usage/cloud/cloud-issue-resolver.mdx} (60%) rename docs/{modules/usage/cloud/cloud-ui.md => usage/cloud/cloud-ui.mdx} (81%) rename docs/{modules/usage/cloud/github-installation.md => usage/cloud/github-installation.mdx} (89%) rename docs/{modules/usage/cloud/gitlab-installation.md => usage/cloud/gitlab-installation.mdx} (73%) rename docs/{modules/usage/cloud/openhands-cloud.md => usage/cloud/openhands-cloud.mdx} (93%) rename docs/{modules/usage/configuration-options.md => usage/configuration-options.mdx} (94%) rename docs/{modules/usage/feedback.md => usage/feedback.mdx} (100%) rename docs/{modules => }/usage/getting-started.mdx (97%) rename docs/{modules/usage/how-to/cli-mode.md => usage/how-to/cli-mode.mdx} (91%) rename docs/{modules/usage/how-to/custom-sandbox-guide.md => usage/how-to/custom-sandbox-guide.mdx} (90%) rename docs/{modules/usage/how-to/debugging.md => usage/how-to/debugging.mdx} (98%) rename docs/{modules/usage/how-to/development-overview.md => usage/how-to/development-overview.mdx} (90%) rename docs/{modules/usage/how-to/evaluation-harness.md => usage/how-to/evaluation-harness.mdx} (99%) rename docs/{modules/usage/how-to/github-action.md => usage/how-to/github-action.mdx} (92%) rename docs/{modules/usage/how-to/gui-mode.md => usage/how-to/gui-mode.mdx} (97%) rename docs/{modules/usage/how-to/headless-mode.md => usage/how-to/headless-mode.mdx} (84%) rename docs/{modules/usage/how-to/websocket-connection.md => usage/how-to/websocket-connection.mdx} (98%) rename docs/{modules => }/usage/installation.mdx (61%) rename docs/{modules/usage/key-features.md => usage/key-features.mdx} (90%) rename docs/{modules/usage/llms/azure-llms.md => usage/llms/azure-llms.mdx} (82%) rename docs/{modules/usage/llms/custom-llm-configs.md => usage/llms/custom-llm-configs.mdx} (92%) rename docs/{modules/usage/llms/google-llms.md => usage/llms/google-llms.mdx} (77%) rename docs/{modules/usage/llms/groq.md => usage/llms/groq.mdx} (84%) rename docs/{modules/usage/llms/litellm-proxy.md => usage/llms/litellm-proxy.mdx} (83%) rename docs/{modules/usage/llms/llms.md => usage/llms/llms.mdx} (87%) rename docs/{modules/usage/llms/local-llms.md => usage/llms/local-llms.mdx} (91%) rename docs/{modules/usage/llms/openai-llms.md => usage/llms/openai-llms.mdx} (85%) rename docs/{modules/usage/llms/openrouter.md => usage/llms/openrouter.mdx} (69%) rename docs/{modules => }/usage/llms/screenshots/1_select_power_user.png (100%) rename docs/{modules => }/usage/llms/screenshots/2_select_model.png (100%) rename docs/{modules => }/usage/llms/screenshots/3_select_devstral.png (100%) rename docs/{modules => }/usage/llms/screenshots/4_set_context_window.png (100%) rename docs/{modules => }/usage/llms/screenshots/5_copy_url.png (100%) rename docs/{modules => }/usage/llms/screenshots/6_copy_to_get_model_name.png (100%) rename docs/{modules/usage/mcp.md => usage/mcp.mdx} (92%) rename docs/{modules/usage/prompting/microagents-keyword.md => usage/prompting/microagents-keyword.mdx} (79%) rename docs/{modules/usage/prompting/microagents-org.md => usage/prompting/microagents-org.mdx} (82%) rename docs/{modules/usage/prompting/microagents-overview.md => usage/prompting/microagents-overview.mdx} (83%) rename docs/{modules/usage/prompting/microagents-public.md => usage/prompting/microagents-public.mdx} (84%) rename docs/{modules/usage/prompting/microagents-repo.md => usage/prompting/microagents-repo.mdx} (88%) rename docs/{modules/usage/prompting/prompting-best-practices.md => usage/prompting/prompting-best-practices.mdx} (86%) rename docs/{modules/usage/customization/repository.md => usage/prompting/repository.mdx} (87%) rename docs/{modules/usage/runtimes/daytona.md => usage/runtimes/daytona.mdx} (92%) rename docs/{modules/usage/runtimes/docker.md => usage/runtimes/docker.mdx} (97%) create mode 100644 docs/usage/runtimes/e2b.mdx rename docs/{modules/usage/runtimes/local.md => usage/runtimes/local.mdx} (88%) rename docs/{modules/usage/runtimes/modal.md => usage/runtimes/modal.mdx} (93%) create mode 100644 docs/usage/runtimes/overview.mdx rename docs/{modules/usage/runtimes/remote.md => usage/runtimes/remote.mdx} (53%) create mode 100644 docs/usage/runtimes/runloop.mdx rename docs/{modules/usage/troubleshooting/troubleshooting.md => usage/troubleshooting/troubleshooting.mdx} (98%) diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml deleted file mode 100644 index f5f4edd4aa..0000000000 --- a/.github/workflows/deploy-docs.yml +++ /dev/null @@ -1,72 +0,0 @@ -# Workflow that builds and deploys the documentation website -name: Deploy Docs to GitHub Pages - -# * Always run on "main" -# * Run on PRs that target the "main" branch and have changes in the "docs" folder or this workflow -on: - push: - branches: - - main - pull_request: - paths: - - 'docs/**' - - '.github/workflows/deploy-docs.yml' - branches: - - main - -# If triggered by a PR, it will be in the same group. However, each commit on main will be in its own unique group -concurrency: - group: ${{ github.workflow }}-${{ (github.head_ref && github.ref) || github.run_id }} - cancel-in-progress: true - -jobs: - # Build the documentation website - build: - if: github.repository == 'All-Hands-AI/OpenHands' - name: Build Docusaurus - runs-on: blacksmith-4vcpu-ubuntu-2204 - steps: - - uses: actions/checkout@v4 - with: - fetch-depth: 0 - - uses: useblacksmith/setup-node@v5 - with: - node-version: 18 - cache: npm - cache-dependency-path: docs/package-lock.json - - name: Set up Python - uses: useblacksmith/setup-python@v6 - with: - python-version: '3.12' - - name: Install dependencies - run: cd docs && npm ci - - name: Build website - run: cd docs && npm run build - - name: Upload Build Artifact - if: github.ref == 'refs/heads/main' - uses: actions/upload-pages-artifact@v3 - with: - path: docs/build - - # Deploy the documentation website - deploy: - if: github.ref == 'refs/heads/main' && github.repository == 'All-Hands-AI/OpenHands' - name: Deploy to GitHub Pages - runs-on: blacksmith-4vcpu-ubuntu-2204 - # This job only runs on "main" so only run one of these jobs at a time - # otherwise it will fail if one is already running - concurrency: - group: ${{ github.workflow }}-${{ github.ref }} - needs: build - # Grant GITHUB_TOKEN the permissions required to make a Pages deployment - permissions: - pages: write # to deploy to Pages - id-token: write # to verify the deployment originates from an appropriate source - # Deploy to the github-pages environment - environment: - name: github-pages - url: ${{ steps.deployment.outputs.page_url }} - steps: - - name: Deploy to GitHub Pages - id: deployment - uses: actions/deploy-pages@v4 diff --git a/docs/.gitignore b/docs/.gitignore deleted file mode 100644 index c72e208daa..0000000000 --- a/docs/.gitignore +++ /dev/null @@ -1,21 +0,0 @@ -# Dependencies -/node_modules - -# Production -/build -/static/swagger-ui - -# Generated files -.docusaurus -.cache-loader - -# Misc -.DS_Store -.env.local -.env.development.local -.env.test.local -.env.production.local - -npm-debug.log* -yarn-debug.log* -yarn-error.log* diff --git a/docs/DOC_STYLE_GUIDE.md b/docs/DOC_STYLE_GUIDE.md index 9c5bcdc494..213e857078 100644 --- a/docs/DOC_STYLE_GUIDE.md +++ b/docs/DOC_STYLE_GUIDE.md @@ -54,9 +54,9 @@ docker run -it \ When adding a note or warning, use the built-in note and warning syntax. Example: -:::note + This section is for advanced users only. -::: + ### Referring to UI Elements diff --git a/docs/README.md b/docs/README.md deleted file mode 100644 index fa64e94f1a..0000000000 --- a/docs/README.md +++ /dev/null @@ -1,55 +0,0 @@ -# OpenHands Documentation - -This website is built using [Docusaurus](https://docusaurus.io/). - -When published, the content will be published at https://docs.all-hands.dev/. - -### Local Development - -```bash -$ cd docs -$ npm install -$ npm run start -``` - -This command starts a local development server and opens up a browser window. -Most changes are reflected live without having to restart the server. - -Alternatively, you can pass a `--locale` argument to render a specific language in dev mode as in: - -``` -$ npm run start --locale pt-BR # for the Brazilian Portuguese version -$ npm run start --locale fr # for the French version -$ npm run start --locale zh-Hans # for the Chinese Han (simplified variant) version -``` - -### Build - -``` -$ npm run build -``` - -This command generates static content into the `build` directory and can be served using any static contents hosting service. -It compiles all languages. - -### Deployment - -Open a new pull request and - when it is merged - the [deploy-docs](.github/workflows/deploy-docs.yml) GH action will take care of everything else. - -## Automatic Translations - -Translations can be automatically updated when the original English content changes, this is done by the script [`translation_updater.py`](./translation_updater.py). - -From the root of the repository, you can run the following: - -```bash -$ export ANTHROPIC_API_KEY= -$ poetry run python docs/translation_updater.py -# ... -# Change detected in docs/modules/usage/getting-started.mdx -# translating... docs/modules/usage/getting-started.mdx pt-BR -# translation done -# ... -``` - -This process uses `claude-sonnet-4-20250514` as base model and each language consumes at least ~30k input tokens and ~35k output tokens. diff --git a/docs/babel.config.js b/docs/babel.config.js deleted file mode 100644 index e00595dae7..0000000000 --- a/docs/babel.config.js +++ /dev/null @@ -1,3 +0,0 @@ -module.exports = { - presets: [require.resolve('@docusaurus/core/lib/babel/preset')], -}; diff --git a/docs/docs.json b/docs/docs.json new file mode 100644 index 0000000000..5b2ba37e40 --- /dev/null +++ b/docs/docs.json @@ -0,0 +1,197 @@ +{ + "$schema": "https://mintlify.com/docs.json", + "theme": "mint", + "name": "All Hands Docs", + "colors": { + "primary": "#99873c", + "light": "#ffe165", + "dark": "#ffe165" + }, + "background": { + "color": { + "light": "#f7f3ee", + "dark": "#0B0D0E" + } + }, + "appearance": { + "default": "light" + }, + "favicon": "/logo-square.png", + "navigation": { + "tabs": [ + { + "tab": "Getting started", + "pages": [ + "index", + "usage/installation", + "usage/getting-started", + "usage/key-features", + { + "group": "OpenHands Cloud", + "pages": [ + "usage/cloud/openhands-cloud", + { + "group": "Installation", + "pages": [ + "usage/cloud/github-installation", + "usage/cloud/gitlab-installation" + ] + }, + "usage/cloud/cloud-ui", + "usage/cloud/cloud-issue-resolver", + "usage/cloud/cloud-api" + ] + }, + { + "group": "Usage Methods", + "pages": [ + "usage/how-to/gui-mode", + "usage/how-to/cli-mode", + "usage/how-to/headless-mode", + "usage/how-to/github-action" + ] + } + ] + }, + { + "tab": "Prompting and Customization", + "pages": [ + "usage/prompting/prompting-best-practices", + "usage/prompting/repository", + { + "group": "Microagents", + "pages": [ + "usage/prompting/microagents-overview", + "usage/prompting/microagents-repo", + "usage/prompting/microagents-keyword", + "usage/prompting/microagents-org", + "usage/prompting/microagents-public" + ] + } + ] + }, + { + "tab": "Advanced Configuration", + "pages": [ + { + "group": "LLM Configuration", + "pages": [ + "usage/llms/llms", + { + "group": "Providers", + "pages": [ + "usage/llms/azure-llms", + "usage/llms/google-llms", + "usage/llms/groq", + "usage/llms/local-llms", + "usage/llms/litellm-proxy", + "usage/llms/openai-llms", + "usage/llms/openrouter" + ] + } + ] + }, + { + "group": "Runtime Configuration", + "pages": [ + "usage/runtimes/overview", + { + "group": "Providers", + "pages": [ + "usage/runtimes/docker", + "usage/runtimes/remote", + "usage/runtimes/local", + { + "group": "Third-Party Providers", + "pages": [ + "usage/runtimes/modal", + "usage/runtimes/daytona", + "usage/runtimes/runloop", + "usage/runtimes/e2b" + ] + } + ] + } + ] + }, + "usage/configuration-options", + "usage/how-to/custom-sandbox-guide", + "usage/mcp" + ] + }, + { + "tab": "Troubleshooting & Feedback", + "pages": [ + "usage/troubleshooting/troubleshooting", + "usage/feedback" + ] + }, + { + "tab": "For OpenHands Developers", + "pages": [ + "usage/how-to/development-overview", + { + "group": "Architecture", + "pages": [ + "usage/architecture/backend", + "usage/architecture/runtime" + ] + }, + "usage/how-to/debugging", + "usage/how-to/evaluation-harness", + "usage/how-to/websocket-connection" + ] + }, + { + "tab": "API Reference", + "openapi": "/openapi.json" + } + ], + "global": { + "anchors": [ + { + "anchor": "Company", + "href": "https://www.all-hands.dev/", + "icon": "house" + }, + { + "anchor": "Blog", + "href": "https://www.all-hands.dev/blog", + "icon": "newspaper" + }, + { + "anchor": "OpenHands Cloud", + "href": "https://app.all-hands.dev", + "icon": "cloud" + } + ] + } + }, + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg" + }, + "navbar": { + "links": [ + ], + "primary": { + "type": "github", + "href": "https://github.com/All-Hands-AI/OpenHands" + } + }, + "footer": { + "socials": { + "slack": "https://join.slack.com/t/openhands-ai/shared_invite/zt-34zm4j0gj-Qz5kRHoca8DFCbqXPS~f_A", + "github": "https://github.com/All-Hands-AI/OpenHands", + "discord": "https://discord.gg/ESHStjSjD4" + } + }, + "contextual": { + "options": [ + "copy", + "view", + "chatgpt", + "claude" + ] + } +} diff --git a/docs/docusaurus.config.ts b/docs/docusaurus.config.ts deleted file mode 100644 index 5f04d2ee17..0000000000 --- a/docs/docusaurus.config.ts +++ /dev/null @@ -1,118 +0,0 @@ -import type * as Preset from '@docusaurus/preset-classic'; -import type { Config } from '@docusaurus/types'; -import { themes as prismThemes } from 'prism-react-renderer'; - -const config: Config = { - title: 'OpenHands', - tagline: 'Code Less, Make More', - favicon: 'img/logo-square.png', - - // Set the production url of your site here - url: 'https://docs.all-hands.dev', - baseUrl: '/', - - // GitHub pages deployment config. - organizationName: 'All-Hands-AI', - projectName: 'OpenHands', - trailingSlash: false, - - onBrokenLinks: 'throw', - onBrokenMarkdownLinks: 'warn', - - // Even if you don't use internationalization, you can use this field to set - // useful metadata like html lang. For example, if your site is Chinese, you - // may want to replace "en" with "zh-Hans". - i18n: { - defaultLocale: 'en', - locales: ['en', 'fr', 'zh-Hans', 'ja', 'pt-BR'], - localeConfigs: { - en: { - htmlLang: 'en-GB', - }, - }, - }, - - markdown: { - mermaid: true, - }, - themes: ['@docusaurus/theme-mermaid'], - plugins: [ - [ - require.resolve('docusaurus-lunr-search'), - { - languages: ['en', 'zh', 'fr', 'ja', 'pt'] - } - ] - ], - presets: [ - [ - 'classic', - { - docs: { - path: 'modules', - routeBasePath: 'modules', - sidebarPath: './sidebars.ts', - exclude: [ - // '**/_*.{js,jsx,ts,tsx,md,mdx}', - // '**/_*/**', - '**/*.test.{js,jsx,ts,tsx}', - '**/__tests__/**', - ], - }, - blog: { - showReadingTime: true, - }, - theme: { - customCss: './src/css/custom.css', - }, - } satisfies Preset.Options, - ], - ], - themeConfig: { - image: 'img/docusaurus.png', - navbar: { - title: 'OpenHands', - logo: { - alt: 'OpenHands', - src: 'img/logo.png', - }, - items: [ - { - type: 'docSidebar', - sidebarId: 'docsSidebar', - position: 'left', - label: 'User Guides', - }, - { - href: 'https://docs.all-hands.dev/swagger-ui/', // FIXME: this should be a relative path, but docusarus steals the click - label: 'API', - position: 'left', - }, - { - type: 'localeDropdown', - position: 'left', - }, - { - type: 'search', - position: 'left', - }, - { - href: 'https://all-hands.dev', - label: 'Company', - position: 'right', - }, - { - href: 'https://github.com/All-Hands-AI/OpenHands', - label: 'GitHub', - position: 'right', - }, - ], - }, - prism: { - theme: prismThemes.oneLight, - darkTheme: prismThemes.oneDark, - }, - } satisfies Preset.ThemeConfig, -}; - -export default config; diff --git a/docs/favicon.svg b/docs/favicon.svg new file mode 100644 index 0000000000..b785c738bf --- /dev/null +++ b/docs/favicon.svg @@ -0,0 +1,19 @@ + + + + + + + + + + + + + + + + + + + diff --git a/docs/generate-swagger-ui.js b/docs/generate-swagger-ui.js deleted file mode 100644 index 6f546f5b77..0000000000 --- a/docs/generate-swagger-ui.js +++ /dev/null @@ -1,102 +0,0 @@ -const fs = require('fs'); -const path = require('path'); -const swaggerUiDist = require('swagger-ui-dist'); - -/** - * This script manually sets up Swagger UI for the Docusaurus documentation. - * - * Why we need this approach: - * 1. Docusaurus doesn't have a built-in way to integrate Swagger UI - * 2. We need to copy the necessary files from swagger-ui-dist to our static directory - * 3. We need to create a custom index.html file that points to our OpenAPI spec - * 4. This approach allows us to customize the Swagger UI to match our documentation style - */ - -// Get the absolute path to the swagger-ui-dist package -const swaggerUiDistPath = swaggerUiDist.getAbsoluteFSPath(); - -// Create the target directory if it doesn't exist -const targetDir = path.join(__dirname, 'static', 'swagger-ui'); -if (!fs.existsSync(targetDir)) { - fs.mkdirSync(targetDir, { recursive: true }); -} - -// Copy all files from swagger-ui-dist to our target directory -const files = fs.readdirSync(swaggerUiDistPath); -files.forEach(file => { - const sourcePath = path.join(swaggerUiDistPath, file); - const targetPath = path.join(targetDir, file); - - // Skip directories and non-essential files - if (fs.statSync(sourcePath).isDirectory() || - file === 'package.json' || - file === 'README.md' || - file.endsWith('.map')) { - return; - } - - fs.copyFileSync(sourcePath, targetPath); -}); - -// Create a custom index.html file that points to our OpenAPI spec -const indexHtml = ` - - - - - OpenHands API Documentation - - - - - - - -
- - - - - - -`; - -fs.writeFileSync(path.join(targetDir, 'index.html'), indexHtml); - -console.log('Swagger UI files generated successfully in static/swagger-ui/'); diff --git a/docs/i18n/fr/code.json b/docs/i18n/fr/code.json deleted file mode 100644 index 20799331e6..0000000000 --- a/docs/i18n/fr/code.json +++ /dev/null @@ -1,427 +0,0 @@ -{ - "footer.title": { - "message": "OpenHands" - }, - "footer.docs": { - "message": "Documents" - }, - "footer.community": { - "message": "Communauté" - }, - "footer.copyright": { - "message": "© {year} OpenHands" - }, - "faq.title": { - "message": "Questions Fréquemment Posées", - "description": "FAQ Title" - }, - "faq.description": { - "message": "Questions Fréquemment Posées" - }, - "faq.section.title.1": { - "message": "Qu'est-ce qu'OpenHands ?", - "description": "First Section Title" - }, - "faq.section.highlight": { - "message": "OpenHands", - "description": "Highlight Text" - }, - "faq.section.description.1": { - "message": "est un ingénieur logiciel autonome qui peut résoudre des tâches d'ingénierie logicielle et de navigation web à tout moment. Il peut exécuter des requêtes en sciences des données, telles que \"Trouver le nombre de demandes de pull à l'repository OpenHands dans les derniers mois\", et des tâches d'ingénierie logicielle, comme \"Veuillez ajouter des tests à ce fichier et vérifier si tous les tests passent. Si ce n'est pas le cas, réparez le fichier.\"", - "description": "Description for OpenHands" - }, - "faq.section.description.2": { - "message": "De plus, OpenHands est une plateforme et communauté pour les développeurs d'agents qui souhaitent tester et évaluer de nouveaux agents.", - "description": "Further Description for OpenHands" - }, - "faq.section.title.2": { - "message": "Support", - "description": "Support Section Title" - }, - "faq.section.support.answer": { - "message": "Si vous rencontrez un problème que d'autres utilisateurs peuvent également avoir, merci de le signaler sur {githubLink}. Si vous avez des difficultés à l'installation ou des questions générales, rejoignez-vous sur {discordLink} ou {slackLink}.", - "description": "Support Answer" - }, - "faq.section.title.3": { - "message": "Comment résoudre un problème sur GitHub avec OpenHands ?", - "description": "GitHub Issue Section Title" - }, - "faq.section.github.steps.intro": { - "message": "Pour résoudre un problème sur GitHub en utilisant OpenHands, envoyez une commande à OpenHands demandant qu'il suit des étapes comme les suivantes :", - "description": "GitHub Steps Introduction" - }, - "faq.section.github.step1": { - "message": "Lisez l'issue https://github.com/All-Hands-AI/OpenHands/issues/1611", - "description": "GitHub Step 1" - }, - "faq.section.github.step2": { - "message": "Cloner le dépôt et vérifier une nouvelle branche", - "description": "GitHub Step 2" - }, - "faq.section.github.step3": { - "message": "Sur la base des instructions dans la description de l'issue, modifiez les fichiers pour résoudre le problème", - "description": "GitHub Step 3" - }, - "faq.section.github.step4": { - "message": "Pousser le résultat à GitHub en utilisant la variable d'environnement GITHUB_TOKEN", - "description": "GitHub Step 4" - }, - "faq.section.github.step5": { - "message": "Dites-moi le lien que je dois utiliser pour envoyer une demande de pull", - "description": "GitHub Step 5" - }, - "faq.section.github.steps.preRun": { - "message": "Avant de lancer OpenHands, vous pouvez faire :", - "description": "GitHub Steps Pre-Run" - }, - "faq.section.github.steps.tokenInfo": { - "message": "où XXX est un jeton GitHub que vous avez créé et qui a les autorisations pour pousser dans le dépôt OpenHands. Si vous n'avez pas d'autorisations de modification du dépôt OpenHands, vous devrez peut-être changer cela en :", - "description": "GitHub Steps Token Info" - }, - "faq.section.github.steps.usernameInfo": { - "message": "où USERNAME est votre nom GitHub.", - "description": "GitHub Steps Username Info" - }, - "faq.section.title.4": { - "message": "Comment OpenHands est-il différent de Devin ?", - "description": "Devin Section Title" - }, - "faq.section.openhands.linkText": { - "message": "Devin", - "description": "Devin Link Text" - }, - "faq.section.openhands.description": { - "message": "est un produit commercial par Cognition Inc., qui a servi d'inspiration initiale pour OpenHands. Les deux visent à bien faire le travail d'ingénierie logicielle, mais vous pouvez télécharger, utiliser et modifier OpenHands, tandis que Devin peut être utilisé uniquement via le site de Cognition. De plus, OpenHands a évolué au-delà de l'inspiration initiale, et est maintenant un écosystème communautaire pour le développement d'agents en général, et nous serions ravis de vous voir rejoindre et", - "description": "Devin Description" - }, - "faq.section.openhands.contribute": { - "message": "contribuer", - "description": "Contribute Link" - }, - "faq.section.title.5": { - "message": "Comment OpenHands est-il différent de ChatGPT ?", - "description": "ChatGPT Section Title" - }, - "faq.section.chatgpt.description": { - "message": "ChatGPT vous pouvez accéder en ligne, il ne se connecte pas aux fichiers locaux et ses capacités d'exécution du code sont limitées. Alors qu'il peut écrire du code, mais c'est difficile à tester ou à exécuter.", - "description": "ChatGPT Description" - }, - "homepage.description": { - "message": "Génération d'code AI pour l'ingénierie logicielle.", - "description": "The homepage description" - }, - "homepage.getStarted": { - "message": "Commencer" - }, - "welcome.message": { - "message": "Bienvenue à OpenHands, un système d'IA autonome ingénieur logiciel capable d'exécuter des tâches d'ingénierie complexes et de collaborer activement avec les utilisateurs sur les projets de développement logiciel." - }, - "theme.ErrorPageContent.title": { - "message": "Cette page a planté.", - "description": "The title of the fallback page when the page crashed" - }, - "theme.BackToTopButton.buttonAriaLabel": { - "message": "Retourner en haut de la page", - "description": "The ARIA label for the back to top button" - }, - "theme.blog.archive.title": { - "message": "Archives", - "description": "The page & hero title of the blog archive page" - }, - "theme.blog.archive.description": { - "message": "Archives", - "description": "The page & hero description of the blog archive page" - }, - "theme.blog.paginator.navAriaLabel": { - "message": "Pagination des listes d'articles du blog", - "description": "The ARIA label for the blog pagination" - }, - "theme.blog.paginator.newerEntries": { - "message": "Nouvelles entrées", - "description": "The label used to navigate to the newer blog posts page (previous page)" - }, - "theme.blog.paginator.olderEntries": { - "message": "Anciennes entrées", - "description": "The label used to navigate to the older blog posts page (next page)" - }, - "theme.blog.post.paginator.navAriaLabel": { - "message": "Pagination des articles du blog", - "description": "The ARIA label for the blog posts pagination" - }, - "theme.blog.post.paginator.newerPost": { - "message": "Article plus récent", - "description": "The blog post button label to navigate to the newer/previous post" - }, - "theme.blog.post.paginator.olderPost": { - "message": "Article plus ancien", - "description": "The blog post button label to navigate to the older/next post" - }, - "theme.blog.post.plurals": { - "message": "Un article|{count} articles", - "description": "Pluralized label for \"{count} posts\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" - }, - "theme.blog.tagTitle": { - "message": "{nPosts} tags avec « {tagName} »", - "description": "The title of the page for a blog tag" - }, - "theme.tags.tagsPageLink": { - "message": "Voir tous les tags", - "description": "The label of the link targeting the tag list page" - }, - "theme.colorToggle.ariaLabel": { - "message": "Basculer entre le mode sombre et clair (actuellement {mode})", - "description": "The ARIA label for the navbar color mode toggle" - }, - "theme.colorToggle.ariaLabel.mode.dark": { - "message": "mode sombre", - "description": "The name for the dark color mode" - }, - "theme.colorToggle.ariaLabel.mode.light": { - "message": "mode clair", - "description": "The name for the light color mode" - }, - "theme.docs.breadcrumbs.navAriaLabel": { - "message": "Bouton de navigation des liens de la page", - "description": "The ARIA label for the breadcrumbs" - }, - "theme.docs.DocCard.categoryDescription.plurals": { - "message": "1 élément|{count} éléments", - "description": "The default description for a category card in the generated index about how many items this category includes" - }, - "theme.docs.paginator.navAriaLabel": { - "message": "Pages de documentation", - "description": "The ARIA label for the docs pagination" - }, - "theme.docs.paginator.previous": { - "message": "Précédent", - "description": "The label used to navigate to the previous doc" - }, - "theme.docs.paginator.next": { - "message": "Suivant", - "description": "The label used to navigate to the next doc" - }, - "theme.docs.tagDocListPageTitle.nDocsTagged": { - "message": "Un document tagué|{count} documents tagués", - "description": "Pluralized label for \"{count} docs tagged\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" - }, - "theme.docs.tagDocListPageTitle": { - "message": "{nDocsTagged} avec \"{tagName}\"", - "description": "The title of the page for a docs tag" - }, - "theme.docs.versionBadge.label": { - "message": "Version: {versionLabel}" - }, - "theme.docs.versions.unreleasedVersionLabel": { - "message": "Ceci est la documentation de la prochaine version {versionLabel} de {siteTitle}.", - "description": "The label used to tell the user that he's browsing an unreleased doc version" - }, - "theme.docs.versions.unmaintainedVersionLabel": { - "message": "Ceci est la documentation de {siteTitle} {versionLabel}, qui n'est plus activement maintenue.", - "description": "The label used to tell the user that he's browsing an unmaintained doc version" - }, - "theme.docs.versions.latestVersionSuggestionLabel": { - "message": "Pour une documentation à jour, consultez la {latestVersionLink} ({versionLabel}).", - "description": "The label used to tell the user to check the latest version" - }, - "theme.docs.versions.latestVersionLinkLabel": { - "message": "dernière version", - "description": "The label used for the latest version suggestion link label" - }, - "theme.common.editThisPage": { - "message": "Éditer cette page", - "description": "The link label to edit the current page" - }, - "theme.common.headingLinkTitle": { - "message": "Lien direct vers {heading}", - "description": "Title for link to heading" - }, - "theme.lastUpdated.atDate": { - "message": " le {date}", - "description": "The words used to describe on which date a page has been last updated" - }, - "theme.lastUpdated.byUser": { - "message": " par {user}", - "description": "The words used to describe by who the page has been last updated" - }, - "theme.lastUpdated.lastUpdatedAtBy": { - "message": "Dernière mise à jour{atDate}{byUser}", - "description": "The sentence used to display when a page has been last updated, and by who" - }, - "theme.navbar.mobileVersionsDropdown.label": { - "message": "Versions", - "description": "The label for the navbar versions dropdown on mobile view" - }, - "theme.NotFound.title": { - "message": "Page introuvable", - "description": "The title of the 404 page" - }, - "theme.tags.tagsListLabel": { - "message": "Tags :", - "description": "The label alongside a tag list" - }, - "theme.admonition.caution": { - "message": "prudence", - "description": "The default label used for the Caution admonition (:::caution)" - }, - "theme.admonition.danger": { - "message": "danger", - "description": "The default label used for the Danger admonition (:::danger)" - }, - "theme.admonition.info": { - "message": "information", - "description": "The default label used for the Info admonition (:::info)" - }, - "theme.admonition.note": { - "message": "remarque", - "description": "The default label used for the Note admonition (:::note)" - }, - "theme.admonition.tip": { - "message": "astuce", - "description": "The default label used for the Tip admonition (:::tip)" - }, - "theme.admonition.warning": { - "message": "prudence", - "description": "The default label used for the Warning admonition (:::warning)" - }, - "theme.AnnouncementBar.closeButtonAriaLabel": { - "message": "Fermer", - "description": "The ARIA label for close button of announcement bar" - }, - "theme.blog.sidebar.navAriaLabel": { - "message": "Navigation vers les articles récents du blog", - "description": "The ARIA label for recent posts in the blog sidebar" - }, - "theme.CodeBlock.copied": { - "message": "Copié", - "description": "The copied button label on code blocks" - }, - "theme.CodeBlock.copyButtonAriaLabel": { - "message": "Copier le code", - "description": "The ARIA label for copy code blocks button" - }, - "theme.CodeBlock.copy": { - "message": "Copier", - "description": "The copy button label on code blocks" - }, - "theme.CodeBlock.wordWrapToggle": { - "message": "Activer/désactiver le retour à la ligne", - "description": "The title attribute for toggle word wrapping button of code block lines" - }, - "theme.DocSidebarItem.expandCategoryAriaLabel": { - "message": "Développer la catégorie '{label}' de la barre latérale", - "description": "The ARIA label to expand the sidebar category" - }, - "theme.DocSidebarItem.collapseCategoryAriaLabel": { - "message": "Réduire la catégorie '{label}' de la barre latérale", - "description": "The ARIA label to collapse the sidebar category" - }, - "theme.NavBar.navAriaLabel": { - "message": "Main", - "description": "The ARIA label for the main navigation" - }, - "theme.navbar.mobileLanguageDropdown.label": { - "message": "Langues", - "description": "The label for the mobile language switcher dropdown" - }, - "theme.NotFound.p1": { - "message": "Nous n'avons pas trouvé ce que vous recherchez.", - "description": "The first paragraph of the 404 page" - }, - "theme.NotFound.p2": { - "message": "Veuillez contacter le propriétaire du site qui vous a lié à l'URL d'origine et leur faire savoir que leur lien est cassé.", - "description": "The 2nd paragraph of the 404 page" - }, - "theme.TOCCollapsible.toggleButtonLabel": { - "message": "Sur cette page", - "description": "The label used by the button on the collapsible TOC component" - }, - "theme.blog.post.readMore": { - "message": "Lire plus", - "description": "The label used in blog post item excerpts to link to full blog posts" - }, - "theme.blog.post.readMoreLabel": { - "message": "En savoir plus sur {title}", - "description": "The ARIA label for the link to full blog posts from excerpts" - }, - "theme.blog.post.readingTime.plurals": { - "message": "Une minute de lecture|{readingTime} minutes de lecture", - "description": "Pluralized label for \"{readingTime} min read\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" - }, - "theme.docs.breadcrumbs.home": { - "message": "Page d'accueil", - "description": "The ARIA label for the home page in the breadcrumbs" - }, - "theme.docs.sidebar.collapseButtonTitle": { - "message": "Réduire le menu latéral", - "description": "The title attribute for collapse button of doc sidebar" - }, - "theme.docs.sidebar.collapseButtonAriaLabel": { - "message": "Réduire le menu latérale", - "description": "The title attribute for collapse button of doc sidebar" - }, - "theme.docs.sidebar.navAriaLabel": { - "message": "Barre de navigation latérale des docs", - "description": "The ARIA label for the sidebar navigation" - }, - "theme.docs.sidebar.closeSidebarButtonAriaLabel": { - "message": "Fermer la barre de navigation", - "description": "The ARIA label for close button of mobile sidebar" - }, - "theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": { - "message": "← Retour au menu principal", - "description": "The label of the back button to return to main menu, inside the mobile navbar sidebar secondary menu (notably used to display the docs sidebar)" - }, - "theme.docs.sidebar.toggleSidebarButtonAriaLabel": { - "message": "Ouvrir/fermer la barre de navigation", - "description": "The ARIA label for hamburger menu button of mobile navigation" - }, - "theme.docs.sidebar.expandButtonTitle": { - "message": "Déplier le menu latéral", - "description": "The ARIA label and title attribute for expand button of doc sidebar" - }, - "theme.docs.sidebar.expandButtonAriaLabel": { - "message": "Déployer le menu latérale", - "description": "The ARIA label and title attribute for expand button of doc sidebar" - }, - "theme.ErrorPageContent.tryAgain": { - "message": "Réessayer", - "description": "The label of the button to try again rendering when the React error boundary captures an error" - }, - "theme.common.skipToMainContent": { - "message": "Aller directement au contenu principal", - "description": "The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation" - }, - "theme.tags.tagsPageTitle": { - "message": "Tags", - "description": "The title of the tag list page" - }, - "theme.unlistedContent.title": { - "message": "Page non répertoriée", - "description": "The unlisted content banner title" - }, - "theme.unlistedContent.message": { - "message": "Cette page n'est pas répertoriée. Les moteurs de recherche ne l'indexeront pas, et seuls les utilisateurs ayant un lien direct peuvent y accéder.", - "description": "The unlisted content banner message" - }, - "Use AI to tackle the toil in your backlog. Our agents have all the same tools as a human developer: they can modify code, run commands, browse the web, call APIs, and yes-even copy code snippets from StackOverflow.": { - "message": "Utilisez l'IA pour gérer les tâches répétitives de votre backlog. Nos agents disposent des mêmes outils qu'un développeur humain : ils peuvent modifier du code, exécuter des commandes, naviguer sur le web, appeler des API et même copier des extraits de code depuis StackOverflow." - }, - "Get started with OpenHands.": { - "message": "Commencer avec OpenHands" - }, - "Most Popular Links": { - "message": "Liens Populaires" - }, - "Customizing OpenHands to a repository": { - "message": "Personnaliser OpenHands pour un dépôt" - }, - "Integrating OpenHands with Github": { - "message": "Intégrer OpenHands avec Github" - }, - "Recommended models to use": { - "message": "Modèles recommandés" - }, - "Connecting OpenHands to your filesystem": { - "message": "Connecter OpenHands à votre système de fichiers" - } -} diff --git a/docs/i18n/fr/docusaurus-plugin-content-blog/options.json b/docs/i18n/fr/docusaurus-plugin-content-blog/options.json deleted file mode 100644 index 0eee9a2e7b..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-blog/options.json +++ /dev/null @@ -1,14 +0,0 @@ -{ - "title": { - "message": "Blog", - "description": "The title for the blog used in SEO" - }, - "description": { - "message": "Blog", - "description": "The description for the blog used in SEO" - }, - "sidebar.title": { - "message": "Articles récents", - "description": "The label for the left sidebar" - } -} diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current.json b/docs/i18n/fr/docusaurus-plugin-content-docs/current.json deleted file mode 100644 index 8693737777..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current.json +++ /dev/null @@ -1,210 +0,0 @@ -{ - "version.label": { - "message": "Next", - "description": "The label for version current" - }, - "sidebar.docsSidebar.category.🤖 Backends LLM": { - "message": "🤖 Backends LLM", - "description": "The label for category 🤖 Backends LLM in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.🚧 Dépannage": { - "message": "🚧 Dépannage", - "description": "The label for category 🚧 Dépannage in sidebar docsSidebar" - }, - "sidebar.apiSidebar.category.Backend": { - "message": "Backend", - "description": "The label for category Backend in sidebar apiSidebar" - }, - "sidebar.docsSidebar.category.User Guides": { - "message": "Guides d'Utilisateur", - "description": "The label for category User Guides in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.Running OpenHands": { - "message": "Exécution d'OpenHands", - "description": "The label for category Running OpenHands in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.Prompting": { - "message": "Prompting", - "description": "The label for category Prompting in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.Architecture": { - "message": "Architecture", - "description": "The label for category Architecture in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Running OpenHands": { - "message": "Exécution d'OpenHands", - "description": "The label for document Running OpenHands in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Getting Started": { - "message": "Commencer", - "description": "The label for document Getting Started in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Key Features": { - "message": "Fonctionnalités Clés", - "description": "The label for document Key Features in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.Customization": { - "message": "Personnalisation", - "description": "The label for category Customization in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.Usage Methods": { - "message": "Méthodes d'Utilisation", - "description": "The label for category Usage Methods in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.Advanced Configuration": { - "message": "Configuration Avancée", - "description": "The label for category Advanced Configuration in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Troubleshooting": { - "message": "Dépannage", - "description": "The label for document Troubleshooting in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Feedback": { - "message": "Retour d'Information", - "description": "The label for document Feedback in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.For OpenHands Developers": { - "message": "Pour les Développeurs OpenHands", - "description": "The label for category For OpenHands Developers in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.About": { - "message": "À Propos", - "description": "The label for document About in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Best Practices": { - "message": "Meilleures Pratiques", - "description": "The label for document Best Practices in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.Microagents": { - "message": "Micro-agents", - "description": "The label for category Microagents in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Overview": { - "message": "Aperçu", - "description": "The label for document Overview in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Repository": { - "message": "Dépôt", - "description": "The label for document Repository in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Public": { - "message": "Public", - "description": "The label for document Public in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Repository Customization": { - "message": "Personnalisation du Dépôt", - "description": "The label for document Repository Customization in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.GUI Mode": { - "message": "Mode GUI", - "description": "The label for document GUI Mode in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.CLI Mode": { - "message": "Mode CLI", - "description": "The label for document CLI Mode in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Headless Mode": { - "message": "Mode Sans Interface", - "description": "The label for document Headless Mode in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Github Action": { - "message": "Action GitHub", - "description": "The label for document Github Action in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.Cloud": { - "message": "Cloud", - "description": "The label for category Cloud in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Openhands Cloud": { - "message": "OpenHands Cloud", - "description": "The label for document Openhands Cloud in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Cloud GitHub Resolver": { - "message": "Résolveur GitHub Cloud", - "description": "The label for document Cloud GitHub Resolver in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.LLM Configuration": { - "message": "Configuration LLM", - "description": "The label for category LLM Configuration in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.Providers": { - "message": "Fournisseurs", - "description": "The label for category Providers in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Azure": { - "message": "Azure", - "description": "The label for document Azure in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Google": { - "message": "Google", - "description": "The label for document Google in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Groq": { - "message": "Groq", - "description": "The label for document Groq in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.LiteLLM Proxy": { - "message": "Proxy LiteLLM", - "description": "The label for document LiteLLM Proxy in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.OpenAI": { - "message": "OpenAI", - "description": "The label for document OpenAI in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.OpenRouter": { - "message": "OpenRouter", - "description": "The label for document OpenRouter in sidebar docsSidebar" - }, - "sidebar.docsSidebar.category.Runtime Configuration": { - "message": "Configuration d'Exécution", - "description": "The label for category Runtime Configuration in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Docker Runtime": { - "message": "Environnement Docker", - "description": "The label for document Docker Runtime in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Remote Runtime": { - "message": "Environnement Distant", - "description": "The label for document Remote Runtime in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Modal Runtime": { - "message": "Environnement Modal", - "description": "The label for document Modal Runtime in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Daytona Runtime": { - "message": "Environnement Daytona", - "description": "The label for document Daytona Runtime in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Local Runtime": { - "message": "Environnement Local", - "description": "The label for document Local Runtime in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Configuration Options": { - "message": "Options de Configuration", - "description": "The label for document Configuration Options in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Custom Sandbox": { - "message": "Bac à Sable Personnalisé", - "description": "The label for document Custom Sandbox in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Development Overview": { - "message": "Aperçu du Développement", - "description": "The label for document Development Overview in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Backend": { - "message": "Backend", - "description": "The label for document Backend in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Runtime": { - "message": "Environnement d'Exécution", - "description": "The label for document Runtime in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Debugging": { - "message": "Débogage", - "description": "The label for document Debugging in sidebar docsSidebar" - }, - "sidebar.docsSidebar.doc.Evaluation": { - "message": "Évaluation", - "description": "The label for document Evaluation in sidebar docsSidebar" - } -} diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/python/python.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/python/python.md deleted file mode 100644 index 7233096e70..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/python/python.md +++ /dev/null @@ -1,5 +0,0 @@ - - -# Documentation Python - -La documentation apparaîtra ici après le déploiement. diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/python/sidebar.json b/docs/i18n/fr/docusaurus-plugin-content-docs/current/python/sidebar.json deleted file mode 100644 index 53257aefea..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/python/sidebar.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "items": ["python/python"], - "label": "Backend", - "type": "categorie" -} diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/about.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/about.md deleted file mode 100644 index 287e4769ed..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/about.md +++ /dev/null @@ -1,25 +0,0 @@ -# À propos d'OpenHands - -## Stratégie de recherche - -Réaliser une réplication complète d'applications de qualité production avec des LLM est une entreprise complexe. Notre stratégie comprend : - -- **Recherche technique fondamentale :** Concentration sur la recherche fondamentale pour comprendre et améliorer les aspects techniques de la génération et de la gestion du code. -- **Planification des tâches :** Développement de capacités pour la détection de bugs, la gestion de base de code et l'optimisation. -- **Évaluation :** Établissement de métriques d'évaluation complètes pour mieux comprendre et améliorer nos agents. - -## Agent par défaut - -Notre Agent par défaut est actuellement le [CodeActAgent](agents), qui est capable de générer du code et de gérer des fichiers. - -## Construit avec - -OpenHands est construit en utilisant une combinaison de frameworks et bibliothèques puissants, fournissant une base solide pour son développement. Voici les technologies clés utilisées dans le projet : - -![FastAPI](https://img.shields.io/badge/FastAPI-black?style=for-the-badge) ![uvicorn](https://img.shields.io/badge/uvicorn-black?style=for-the-badge) ![LiteLLM](https://img.shields.io/badge/LiteLLM-black?style=for-the-badge) ![Docker](https://img.shields.io/badge/Docker-black?style=for-the-badge) ![Ruff](https://img.shields.io/badge/Ruff-black?style=for-the-badge) ![MyPy](https://img.shields.io/badge/MyPy-black?style=for-the-badge) ![LlamaIndex](https://img.shields.io/badge/LlamaIndex-black?style=for-the-badge) ![React](https://img.shields.io/badge/React-black?style=for-the-badge) - -Veuillez noter que la sélection de ces technologies est en cours, et des technologies supplémentaires peuvent être ajoutées ou des existantes peuvent être supprimées à mesure que le projet évolue. Nous nous efforçons d'adopter les outils les plus appropriés et efficaces pour améliorer les capacités d'OpenHands. - -## Licence - -Distribué sous la [Licence](https://github.com/All-Hands-AI/OpenHands/blob/main/LICENSE) MIT. diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/agents.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/agents.md deleted file mode 100644 index 90b1027d62..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/agents.md +++ /dev/null @@ -1,23 +0,0 @@ -# 🧠 Agent Principal et Capacités - -## CodeActAgent - -### Description - -Cet agent implémente l'idée CodeAct ([article](https://arxiv.org/abs/2402.01030), [tweet](https://twitter.com/xingyaow_/status/1754556835703751087)) qui consolide les **act**ions des agents LLM dans un espace d'action **code** unifié pour la _simplicité_ et la _performance_. - -L'idée conceptuelle est illustrée ci-dessous. À chaque tour, l'agent peut : - -1. **Converser** : Communiquer avec les humains en langage naturel pour demander des clarifications, des confirmations, etc. -2. **CodeAct** : Choisir d'effectuer la tâche en exécutant du code - -- Exécuter n'importe quelle commande Linux `bash` valide -- Exécuter n'importe quel code `Python` valide avec [un interpréteur Python interactif](https://ipython.org/). Ceci est simulé via la commande `bash`, voir le système de plugins ci-dessous pour plus de détails. - -![image](https://github.com/All-Hands-AI/OpenHands/assets/38853559/92b622e3-72ad-4a61-8f41-8c040b6d5fb3) - -### Démo - -https://github.com/All-Hands-AI/OpenHands/assets/38853559/f592a192-e86c-4f48-ad31-d69282d5f6ac - -_Exemple de CodeActAgent avec `gpt-4-turbo-2024-04-09` réalisant une tâche de science des données (régression linéaire)_. diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture.mdx b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture.mdx deleted file mode 100644 index fa6436aa22..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture.mdx +++ /dev/null @@ -1,50 +0,0 @@ ---- -sidebar_position: 4 ---- - -# 🏛️ Aperçu de l'Architecture Système - -Voici un aperçu de haut niveau de l'architecture du système. Le système est divisé en deux composants principaux : le frontend et le backend. Le frontend est responsable de la gestion des interactions avec l'utilisateur et de l'affichage des résultats. Le backend est responsable de la gestion de la logique métier et de l'exécution des agents. - -![system_architecture.svg](/img/system_architecture.svg) - -Cet aperçu est simplifié pour montrer les principaux composants et leurs interactions. Pour une vue plus détaillée de l'architecture du backend, consultez la section [Architecture du Backend](#backend-architecture-fr). - -# Architecture du Backend {#backend-architecture-fr} - -_**Avertissement**: L'architecture du backend est en cours de développement et est sujette à modifications. Le schéma suivant montre l'architecture actuelle du backend basée sur le commit indiqué dans le pied de page du schéma._ - -![backend_architecture.svg](/img/backend_architecture.svg) - -
- Mise à jour de ce Schéma -
- La génération du schéma d'architecture du backend est partiellement automatisée. - Le schéma est généré à partir des annotations de type dans le code en utilisant l'outil py2puml. - Le schéma est ensuite revu manuellement, ajusté et exporté en PNG et SVG. - - ## Prérequis - - - Un environnement Python dans lequel openhands est exécutable - (selon les instructions du fichier README.md à la racine du dépôt) - - [py2puml](https://github.com/lucsorel/py2puml) installé - -## Étapes - -1. Générez automatiquement le schéma en exécutant la commande suivante depuis la racine du dépôt : - `py2puml openhands openhands > docs/architecture/backend_architecture.puml` - -2. Ouvrez le fichier généré dans un éditeur PlantUML, par exemple Visual Studio Code avec l'extension PlantUML ou [PlantText](https://www.planttext.com/) - -3. Révisez le PUML généré et apportez toutes les modifications nécessaires au schéma (ajoutez les parties manquantes, corrigez les erreurs, améliorez l'agencement). - _py2puml crée le schéma à partir des annotations de type dans le code, donc les annotations de type manquantes ou incorrectes peuvent entraîner un schéma incomplet ou incorrect._ - -4. Examinez la différence entre le nouveau schéma et le précédent et vérifiez manuellement si les modifications sont correctes. - _Assurez-vous de ne pas supprimer les parties ajoutées manuellement au schéma par le passé et qui sont toujours pertinentes._ - -5. Ajoutez le hash du commit qui a été utilisé pour générer le schéma dans le pied de page du schéma. - -6. Exporte le schéma sous forme de fichiers PNG et SVG et remplacez les schémas existants dans le répertoire `docs/architecture`. Cela peut être fait avec (par exemple [PlantText](https://www.planttext.com/)) - -
-
diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture/backend.mdx b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture/backend.mdx deleted file mode 100644 index 704284ced1..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture/backend.mdx +++ /dev/null @@ -1,54 +0,0 @@ -# 🏛️ Architecture du Système - -
- Diagramme d'Architecture OpenHands 4 juillet 2024 -

Diagramme d'Architecture OpenHands (4 juillet 2024)

-
- -Voici une vue d'ensemble de l'architecture du système. Le système est divisé en deux composants principaux : le frontend et le backend. Le frontend est responsable de la gestion des interactions utilisateur et de l'affichage des résultats. Le backend est responsable de la gestion de la logique métier et de l'exécution des agents. - -# Architecture Frontend {#frontend-architecture-en} - -![system_architecture.svg](/img/system_architecture.svg) - -Cette vue d'ensemble est simplifiée pour montrer les composants principaux et leurs interactions. Pour une vue plus détaillée de l'architecture backend, consultez la section Architecture Backend ci-dessous. - -# Architecture Backend {#backend-architecture-en} - -_**Avertissement** : L'architecture backend est en cours de développement et peut être modifiée. Le diagramme suivant montre l'architecture actuelle du backend basée sur le commit indiqué dans le pied de page du diagramme._ - -![backend_architecture.svg](/img/backend_architecture.svg) - -
- Mise à jour de ce diagramme -
- La génération du diagramme d'architecture backend est partiellement automatisée. - Le diagramme est généré à partir des annotations de type dans le code en utilisant l'outil - py2puml. Le diagramme est ensuite manuellement révisé, ajusté et exporté en PNG - et SVG. - - ## Prérequis - - - Environnement Python opérationnel dans lequel openhands est exécutable - (selon les instructions du fichier README.md à la racine du dépôt) - - [py2puml](https://github.com/lucsorel/py2puml) installé - -## Étapes - -1. Générer automatiquement le diagramme en exécutant la commande suivante depuis la racine du dépôt : - `py2puml openhands openhands > docs/architecture/backend_architecture.puml` - -2. Ouvrir le fichier généré dans un éditeur PlantUML, par exemple Visual Studio Code avec l'extension PlantUML ou [PlantText](https://www.planttext.com/) - -3. Examiner le PUML généré et faire tous les ajustements nécessaires au diagramme (ajouter les parties manquantes, corriger les erreurs, améliorer le positionnement). - _py2puml crée le diagramme basé sur les annotations de type dans le code, donc des annotations manquantes ou incorrectes peuvent entraîner un diagramme incomplet ou incorrect._ - -4. Examiner la différence entre le nouveau diagramme et le précédent et vérifier manuellement si les changements sont corrects. - _Assurez-vous de ne pas supprimer des parties qui ont été ajoutées manuellement au diagramme dans le passé et qui sont toujours pertinentes._ - -5. Ajouter le hash du commit qui a été utilisé pour générer le diagramme dans le pied de page du diagramme. - -6. Exporter le diagramme en fichiers PNG et SVG et remplacer les diagrammes existants dans le répertoire `docs/architecture`. Cela peut être fait avec (par exemple [PlantText](https://www.planttext.com/)) - -
-
diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture/runtime.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture/runtime.md deleted file mode 100644 index e92b98bacf..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/architecture/runtime.md +++ /dev/null @@ -1,128 +0,0 @@ -# 📦 Docker Runtime - -Le Docker Runtime d'OpenHands est le composant central qui permet l'exécution sécurisée et flexible des actions d'un agent IA. -Il crée un environnement isolé (sandbox) en utilisant Docker, où du code arbitraire peut être exécuté en toute sécurité sans risquer de compromettre le système hôte. - -## Pourquoi avons-nous besoin d'un environnement d'exécution isolé ? - -OpenHands doit exécuter du code arbitraire dans un environnement sécurisé et isolé pour plusieurs raisons : - -1. Sécurité : L'exécution de code non fiable peut présenter des risques importants pour le système hôte. Un environnement isolé empêche le code malveillant d'accéder ou de modifier les ressources du système hôte -2. Cohérence : Un environnement isolé garantit que l'exécution du code est cohérente sur différentes machines et configurations, éliminant les problèmes du type "ça marche sur ma machine" -3. Contrôle des ressources : L'isolation permet un meilleur contrôle de l'allocation et de l'utilisation des ressources, empêchant les processus incontrôlés d'affecter le système hôte -4. Isolation : Différents projets ou utilisateurs peuvent travailler dans des environnements isolés sans interférer les uns avec les autres ou avec le système hôte -5. Reproductibilité : Les environnements isolés facilitent la reproduction des bugs et des problèmes, car l'environnement d'exécution est cohérent et contrôlable - -## Comment fonctionne le Runtime ? - -Le système Runtime d'OpenHands utilise une architecture client-serveur implémentée avec des conteneurs Docker. Voici un aperçu de son fonctionnement : - -```mermaid -graph TD - A[Image Docker personnalisée fournie par l'utilisateur] --> B[Backend OpenHands] - B -->|Construit| C[Image OH Runtime] - C -->|Lance| D[Action Executor] - D -->|Initialise| E[Navigateur] - D -->|Initialise| F[Shell Bash] - D -->|Initialise| G[Plugins] - G -->|Initialise| L[Serveur Jupyter] - - B -->|Crée| H[Agent] - B -->|Crée| I[EventStream] - I <--->|Exécute l'action pour - obtenir l'observation - via API REST - | D - - H -->|Génère l'action| I - I -->|Obtient l'observation| H - - subgraph "Conteneur Docker" - D - E - F - G - L - end -``` - -1. Entrée utilisateur : L'utilisateur fournit une image Docker de base personnalisée -2. Construction de l'image : OpenHands construit une nouvelle image Docker (l'"image OH runtime") basée sur l'image fournie par l'utilisateur. Cette nouvelle image inclut le code spécifique à OpenHands, principalement le "client runtime" -3. Lancement du conteneur : Lorsqu'OpenHands démarre, il lance un conteneur Docker utilisant l'image OH runtime -4. Initialisation du serveur d'exécution d'actions : Le serveur d'exécution d'actions initialise un `ActionExecutor` à l'intérieur du conteneur, configurant les composants nécessaires comme un shell bash et chargeant les plugins spécifiés -5. Communication : Le backend OpenHands (`openhands/runtime/impl/eventstream/eventstream_runtime.py`) communique avec le serveur d'exécution d'actions via une API RESTful, envoyant des actions et recevant des observations -6. Exécution d'actions : Le client runtime reçoit les actions du backend, les exécute dans l'environnement isolé, et renvoie des observations -7. Retour d'observation : Le serveur d'exécution d'actions renvoie les résultats d'exécution au backend OpenHands sous forme d'observations - -Le rôle du client : - -- Il agit comme intermédiaire entre le backend OpenHands et l'environnement isolé -- Il exécute divers types d'actions (commandes shell, opérations sur fichiers, code Python, etc.) en toute sécurité dans le conteneur -- Il gère l'état de l'environnement isolé, y compris le répertoire de travail actuel et les plugins chargés -- Il formate et renvoie les observations au backend, assurant une interface cohérente pour le traitement des résultats - -## Comment OpenHands construit et maintient les images OH Runtime - -L'approche d'OpenHands pour construire et gérer les images runtime assure efficacité, cohérence et flexibilité dans la création et la maintenance des images Docker pour les environnements de production et de développement. - -Consultez le [code pertinent](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/runtime/utils/runtime_build.py) si vous êtes intéressé par plus de détails. - -### Système de marquage d'images - -OpenHands utilise un système à trois tags pour ses images runtime afin d'équilibrer reproductibilité et flexibilité. -Les tags peuvent être dans l'un des 2 formats suivants : - -- **Tag versionné** : `oh_v{openhands_version}_{base_image}` (ex. : `oh_v0.9.9_nikolaik_s_python-nodejs_t_python3.12-nodejs22`) -- **Tag de verrouillage** : `oh_v{openhands_version}_{16_digit_lock_hash}` (ex. : `oh_v0.9.9_1234567890abcdef`) -- **Tag source** : `oh_v{openhands_version}_{16_digit_lock_hash}_{16_digit_source_hash}` - (ex. : `oh_v0.9.9_1234567890abcdef_1234567890abcdef`) - -#### Tag source - Le plus spécifique - -Il s'agit des 16 premiers chiffres du MD5 du hash du répertoire pour le répertoire source. Cela donne un hash -uniquement pour la source openhands. - -#### Tag de verrouillage - -Ce hash est construit à partir des 16 premiers chiffres du MD5 de : - -- Le nom de l'image de base sur laquelle l'image a été construite (ex. : `nikolaik/python-nodejs:python3.12-nodejs22`) -- Le contenu du `pyproject.toml` inclus dans l'image. -- Le contenu du `poetry.lock` inclus dans l'image. - -Cela donne effectivement un hash pour les dépendances d'Openhands indépendamment du code source. - -#### Tag versionné - Le plus générique - -Ce tag est une concaténation de la version openhands et du nom de l'image de base (transformé pour s'adapter au standard des tags). - -#### Processus de construction - -Lors de la génération d'une image... - -- **Pas de reconstruction** : OpenHands vérifie d'abord si une image avec le même **tag source le plus spécifique** existe. S'il existe une telle image, aucune construction n'est effectuée - l'image existante est utilisée. -- **Reconstruction la plus rapide** : OpenHands vérifie ensuite si une image avec le **tag de verrouillage générique** existe. S'il existe une telle image, OpenHands construit une nouvelle image basée sur celle-ci, contournant toutes les étapes d'installation (comme `poetry install` et `apt-get`) sauf une opération finale pour copier le code source actuel. La nouvelle image est marquée uniquement avec un tag **source**. -- **Reconstruction acceptable** : Si ni un tag **source** ni un tag **verrouillage** n'existe, une image sera construite basée sur l'image avec le tag **versionné**. Dans l'image avec tag versionné, la plupart des dépendances devraient déjà être installées, ce qui permet de gagner du temps. -- **Reconstruction la plus lente** : Si aucun des trois tags n'existe, une toute nouvelle image est construite basée sur l'image de base (ce qui est une opération plus lente). Cette nouvelle image est marquée avec tous les tags **source**, **verrouillage** et **versionné**. - -Cette approche de marquage permet à OpenHands de gérer efficacement les environnements de développement et de production. - -1. Un code source et un Dockerfile identiques produisent toujours la même image (via des tags basés sur des hashs) -2. Le système peut rapidement reconstruire des images lorsque des changements mineurs se produisent (en exploitant des images compatibles récentes) -3. Le tag **verrouillage** (ex., `runtime:oh_v0.9.3_1234567890abcdef`) pointe toujours vers la dernière construction pour une combinaison particulière d'image de base, de dépendances et de version OpenHands - -## Système de plugins Runtime - -Le Runtime OpenHands prend en charge un système de plugins qui permet d'étendre les fonctionnalités et de personnaliser l'environnement d'exécution. Les plugins sont initialisés au démarrage du client runtime. - -Consultez [un exemple de plugin Jupyter ici](https://github.com/All-Hands-AI/OpenHands/blob/ecf4aed28b0cf7c18d4d8ff554883ba182fc6bdd/openhands/runtime/plugins/jupyter/__init__.py#L21-L55) si vous souhaitez implémenter votre propre plugin. - -*Plus de détails sur le système de plugins sont encore en construction - les contributions sont les bienvenues !* - -Aspects clés du système de plugins : - -1. Définition du plugin : Les plugins sont définis comme des classes Python qui héritent d'une classe de base `Plugin` -2. Enregistrement du plugin : Les plugins disponibles sont enregistrés dans un dictionnaire `ALL_PLUGINS` -3. Spécification du plugin : Les plugins sont associés à `Agent.sandbox_plugins: list[PluginRequirement]`. Les utilisateurs peuvent spécifier quels plugins charger lors de l'initialisation du runtime -4. Initialisation : Les plugins sont initialisés de manière asynchrone au démarrage du client runtime -5. Utilisation : Le client runtime peut utiliser les plugins initialisés pour étendre ses capacités (par exemple, le JupyterPlugin pour exécuter des cellules IPython) diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-api.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-api.md deleted file mode 100644 index 7c5126eb3a..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-api.md +++ /dev/null @@ -1,177 +0,0 @@ -# API Cloud OpenHands - -OpenHands Cloud fournit une API REST qui vous permet d'interagir programmatiquement avec le service. Cela est utile si vous souhaitez facilement lancer vos propres tâches depuis vos programmes de manière flexible. - -Ce guide explique comment obtenir une clé API et utiliser l'API pour démarrer des conversations. -Pour des informations plus détaillées sur l'API, consultez la [Référence API OpenHands](https://docs.all-hands.dev/swagger-ui/). - -## Obtention d'une clé API - -Pour utiliser l'API OpenHands Cloud, vous devrez générer une clé API : - -1. Connectez-vous à votre compte [OpenHands Cloud](https://app.all-hands.dev) -2. Accédez à la [page Paramètres](https://app.all-hands.dev/settings) -3. Localisez la section "Clés API" -4. Cliquez sur "Générer une nouvelle clé" -5. Donnez à votre clé un nom descriptif (par exemple, "Développement", "Production") -6. Copiez la clé API générée et conservez-la en lieu sûr - elle ne sera affichée qu'une seule fois - -![Génération de clé API](/img/docs/api-key-generation.png) - -## Utilisation de l'API - -### Démarrer une nouvelle conversation - -Pour démarrer une nouvelle conversation avec OpenHands effectuant une tâche, vous devrez faire une requête POST vers le point de terminaison de conversation. - -#### Paramètres de la requête - -| Paramètre | Type | Obligatoire | Description | -|-----------|------|-------------|-------------| -| `initial_user_msg` | chaîne | Oui | Le message initial pour démarrer la conversation | -| `repository` | chaîne | Non | Nom du dépôt Git pour fournir du contexte au format `propriétaire/repo`. Vous devez avoir accès au dépôt. | - -#### Exemples - -
-cURL - -```bash -curl -X POST "https://app.all-hands.dev/api/conversations" \ - -H "Authorization: Bearer YOUR_API_KEY" \ - -H "Content-Type: application/json" \ - -d '{ - "initial_user_msg": "Check whether there is any incorrect information in the README.md file and send a PR to fix it if so.", - "repository": "yourusername/your-repo" - }' -``` -
- -
-Python (avec requests) - -```python -import requests - -api_key = "YOUR_API_KEY" -url = "https://app.all-hands.dev/api/conversations" - -headers = { - "Authorization": f"Bearer {api_key}", - "Content-Type": "application/json" -} - -data = { - "initial_user_msg": "Check whether there is any incorrect information in the README.md file and send a PR to fix it if so.", - "repository": "yourusername/your-repo" -} - -response = requests.post(url, headers=headers, json=data) -conversation = response.json() - -print(f"Conversation Link: https://app.all-hands.dev/conversations/{conversation['conversation_id']}") -print(f"Status: {conversation['status']}") -``` -
- -
-TypeScript/JavaScript (avec fetch) - -```typescript -const apiKey = "YOUR_API_KEY"; -const url = "https://app.all-hands.dev/api/conversations"; - -const headers = { - "Authorization": `Bearer ${apiKey}`, - "Content-Type": "application/json" -}; - -const data = { - initial_user_msg: "Check whether there is any incorrect information in the README.md file and send a PR to fix it if so.", - repository: "yourusername/your-repo" -}; - -async function startConversation() { - try { - const response = await fetch(url, { - method: "POST", - headers: headers, - body: JSON.stringify(data) - }); - - const conversation = await response.json(); - - console.log(`Conversation Link: https://app.all-hands.dev/conversations/${conversation.id}`); - console.log(`Status: ${conversation.status}`); - - return conversation; - } catch (error) { - console.error("Error starting conversation:", error); - } -} - -startConversation(); -``` - -
- -#### Réponse - -L'API renverra un objet JSON avec les détails de la conversation créée : - -```json -{ - "status": "ok", - "conversation_id": "abc1234", -} -``` - -Vous pouvez également recevoir une `AuthenticationError` si : - -1. Vous avez fourni une clé API invalide -2. Vous avez fourni un nom de dépôt incorrect -3. Vous n'avez pas accès au dépôt - - -### Récupération du statut d'une conversation - -Vous pouvez vérifier le statut d'une conversation en faisant une requête GET vers le point de terminaison de conversation. - -#### Point de terminaison - -``` -GET https://app.all-hands.dev/api/conversations/{conversation_id} -``` - -#### Exemple - -
-cURL - -```bash -curl -X GET "https://app.all-hands.dev/api/conversations/{conversation_id}" \ - -H "Authorization: Bearer YOUR_API_KEY" -``` -
- -#### Réponse - -La réponse est formatée comme suit : - -```json -{ - "conversation_id":"abc1234", - "title":"Update README.md", - "created_at":"2025-04-29T15:13:51.370706Z", - "last_updated_at":"2025-04-29T15:13:57.199210Z", - "status":"RUNNING", - "selected_repository":"yourusername/your-repo", - "trigger":"gui" -} -``` - -## Limites de taux - -L'API a une limite de 10 conversations simultanées par compte. Si vous avez besoin d'une limite plus élevée pour votre cas d'utilisation, veuillez nous contacter à [contact@all-hands.dev](mailto:contact@all-hands.dev). - -Si vous dépassez cette limite, l'API renverra une réponse 429 Too Many Requests. diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-issue-resolver.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-issue-resolver.md deleted file mode 100644 index 9a10f097f3..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-issue-resolver.md +++ /dev/null @@ -1,56 +0,0 @@ -# Résolveur de Problèmes Cloud - -Le Résolveur de Problèmes Cloud automatise les corrections de code et fournit une assistance intelligente pour vos dépôts sur GitHub et GitLab. - -## Configuration - -Le Résolveur de Problèmes Cloud est disponible automatiquement lorsque vous accordez l'accès au dépôt OpenHands Cloud : -- [Accès au dépôt GitHub](./github-installation#adding-repository-access) -- [Accès au dépôt GitLab](./gitlab-installation#adding-repository-access) - -![Ajout d'accès au dépôt à OpenHands](/img/cloud/add-repo.png) - -## Utilisation - -Après avoir accordé l'accès au dépôt OpenHands Cloud, vous pouvez utiliser le Résolveur de Problèmes Cloud sur les problèmes et les pull/merge requests dans vos dépôts. - -### Travailler avec les Problèmes - -Sur votre dépôt, étiquetez un problème avec `openhands` ou ajoutez un message commençant par `@openhands`. OpenHands va : -1. Commenter le problème pour vous faire savoir qu'il y travaille - - Vous pouvez cliquer sur le lien pour suivre la progression sur OpenHands Cloud -2. Ouvrir une pull request (GitHub) ou une merge request (GitLab) s'il détermine que le problème a été résolu avec succès -3. Commenter le problème avec un résumé des tâches effectuées et un lien vers la PR/MR - -![Résolveur de problèmes OpenHands en action](/img/cloud/issue-resolver.png) - -#### Exemples de Commandes pour les Problèmes - -Voici quelques exemples de commandes que vous pouvez utiliser avec le résolveur de problèmes : - -``` -@openhands lisez la description du problème et corrigez-le -``` - -### Travailler avec les Pull/Merge Requests - -Pour qu'OpenHands travaille sur les pull requests (GitHub) ou les merge requests (GitLab), mentionnez `@openhands` dans les commentaires pour : -- Poser des questions -- Demander des mises à jour -- Obtenir des explications de code - -OpenHands va : -1. Commenter pour vous faire savoir qu'il y travaille -2. Effectuer la tâche demandée - -#### Exemples de Commandes pour les Pull/Merge Requests - -Voici quelques exemples de commandes que vous pouvez utiliser avec les pull/merge requests : - -``` -@openhands reflétez les commentaires de la revue -``` - -``` -@openhands corrigez les conflits de fusion et assurez-vous que le CI passe -``` diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-ui.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-ui.md deleted file mode 100644 index a54a9c1822..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/cloud-ui.md +++ /dev/null @@ -1,29 +0,0 @@ -# Interface Cloud - -L'interface Cloud fournit une interface web pour interagir avec OpenHands AI. Cette page explique comment accéder et utiliser l'interface Cloud d'OpenHands. - -## Accès à l'Interface - -L'interface Cloud d'OpenHands est accessible à [app.all-hands.dev](https://app.all-hands.dev). Vous devrez vous connecter avec votre compte GitHub ou GitLab pour accéder à l'interface. - - - - -## Fonctionnalités Clés - -Pour des informations détaillées sur les fonctionnalités disponibles dans l'interface Cloud d'OpenHands, veuillez consulter la section [Fonctionnalités Clés](../key-features.md) de la documentation. - -## Paramètres - -La page des paramètres vous permet de : - -1. Configurer les préférences de votre compte -2. Gérer l'accès aux dépôts -3. Générer des clés API pour un accès programmatique -4. Personnaliser votre expérience OpenHands - -## Prochaines Étapes - -- [Utiliser le Résolveur de Problèmes Cloud](./cloud-issue-resolver.md) pour automatiser les corrections de code et obtenir de l'aide -- [En savoir plus sur l'API Cloud](./cloud-api.md) pour un accès programmatique -- [Retourner à la Mise en Route](./openhands-cloud.md) diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/github-installation.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/github-installation.md deleted file mode 100644 index 222102e992..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/github-installation.md +++ /dev/null @@ -1,57 +0,0 @@ -# Installation GitHub - -Ce guide vous accompagne dans le processus d'installation et de configuration d'OpenHands Cloud pour vos dépôts GitHub. - -## Prérequis - -- Un compte GitHub -- Accès à OpenHands Cloud - -## Étapes d'Installation - -1. Connectez-vous à [OpenHands Cloud](https://app.all-hands.dev) -2. Si vous n'avez pas encore connecté votre compte GitHub : - - Cliquez sur `Se connecter à GitHub` - - Examinez et acceptez les conditions d'utilisation - - Autorisez l'application OpenHands AI - -## Ajout d'Accès au Dépôt - -Vous pouvez accorder à OpenHands l'accès à des dépôts spécifiques : - -1. Cliquez sur le menu déroulant `Sélectionner un projet GitHub`, puis sélectionnez `Ajouter plus de dépôts...` -2. Sélectionnez votre organisation et choisissez les dépôts spécifiques auxquels vous souhaitez accorder l'accès à OpenHands. - - OpenHands demande des jetons à courte durée de vie (expiration de 8 heures) avec ces permissions : - - Actions : Lecture et écriture - - Administration : Lecture seule - - Statuts de commit : Lecture et écriture - - Contenus : Lecture et écriture - - Problèmes : Lecture et écriture - - Métadonnées : Lecture seule - - Pull requests : Lecture et écriture - - Webhooks : Lecture et écriture - - Workflows : Lecture et écriture - - L'accès au dépôt pour un utilisateur est accordé en fonction de : - - Permission accordée pour le dépôt - - Permissions GitHub de l'utilisateur (propriétaire/collaborateur) -3. Cliquez sur `Installer & Autoriser` - -![Ajout de l'accès au dépôt à OpenHands](/img/cloud/add-repo.png) - -## Modification de l'Accès au Dépôt - -Vous pouvez modifier l'accès au dépôt à tout moment : -* En utilisant le même workflow `Sélectionner un projet GitHub > Ajouter plus de dépôts`, ou -* En visitant la page Paramètres et en sélectionnant `Configurer les Dépôts GitHub` dans la section `Paramètres GitHub`. - -## Utilisation d'OpenHands avec GitHub - -Une fois que vous avez accordé l'accès au dépôt, vous pouvez utiliser OpenHands avec vos dépôts GitHub. - -Pour plus de détails sur l'utilisation d'OpenHands avec les problèmes et les pull requests GitHub, consultez la documentation du [Résolveur de Problèmes Cloud](./cloud-issue-resolver.md). - -## Prochaines Étapes - -- [Accéder à l'Interface Cloud](./cloud-ui.md) pour interagir avec l'interface web -- [Utiliser le Résolveur de Problèmes Cloud](./cloud-issue-resolver.md) pour automatiser les corrections de code et obtenir de l'aide -- [Utiliser l'API Cloud](./cloud-api.md) pour interagir programmatiquement avec OpenHands diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/gitlab-installation.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/gitlab-installation.md deleted file mode 100644 index 06ce63aaa0..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/gitlab-installation.md +++ /dev/null @@ -1,50 +0,0 @@ -# Installation GitLab - -Ce guide vous accompagne dans le processus d'installation et de configuration d'OpenHands Cloud pour vos dépôts GitLab. - -## Prérequis - -- Un compte GitLab -- Accès à OpenHands Cloud - -## Étapes d'Installation - -1. Connectez-vous à [OpenHands Cloud](https://app.all-hands.dev) -2. Si vous n'avez pas encore connecté votre compte GitLab : - - Cliquez sur `Se connecter à GitLab` - - Examinez et acceptez les conditions d'utilisation - - Autorisez l'application OpenHands AI - -## Ajout d'Accès au Dépôt - -Vous pouvez accorder à OpenHands l'accès à des dépôts spécifiques : - -1. Cliquez sur le menu déroulant `Sélectionner un projet GitLab`, puis sélectionnez `Ajouter plus de dépôts...` -2. Sélectionnez votre organisation et choisissez les dépôts spécifiques auxquels vous souhaitez accorder l'accès à OpenHands. - - OpenHands demande des permissions avec ces portées : - - api : Accès complet à l'API - - read_user : Lecture des informations utilisateur - - read_repository : Lecture des informations du dépôt - - write_repository : Écriture dans le dépôt - - L'accès au dépôt pour un utilisateur est accordé en fonction de : - - Permission accordée pour le dépôt - - Permissions GitLab de l'utilisateur (propriétaire/mainteneur/développeur) -3. Cliquez sur `Installer & Autoriser` - -## Modification de l'Accès au Dépôt - -Vous pouvez modifier l'accès au dépôt à tout moment : -* En utilisant le même workflow `Sélectionner un projet GitLab > Ajouter plus de dépôts`, ou -* En visitant la page Paramètres et en sélectionnant `Configurer les Dépôts GitLab` dans la section `Paramètres GitLab`. - -## Utilisation d'OpenHands avec GitLab - -Une fois que vous avez accordé l'accès au dépôt, vous pouvez utiliser OpenHands avec vos dépôts GitLab. - -Pour plus de détails sur l'utilisation d'OpenHands avec les problèmes et les merge requests GitLab, consultez la documentation du [Résolveur de Problèmes Cloud](./cloud-issue-resolver.md). - -## Prochaines Étapes - -- [Accéder à l'Interface Cloud](./cloud-ui.md) pour interagir avec l'interface web -- [Utiliser le Résolveur de Problèmes Cloud](./cloud-issue-resolver.md) pour automatiser les corrections de code et obtenir de l'aide -- [Utiliser l'API Cloud](./cloud-api.md) pour interagir programmatiquement avec OpenHands diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/openhands-cloud.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/openhands-cloud.md deleted file mode 100644 index 0b3d736a8d..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/cloud/openhands-cloud.md +++ /dev/null @@ -1,24 +0,0 @@ -# OpenHands Cloud - -OpenHands Cloud est la version hébergée dans le cloud d'OpenHands par All Hands AI. - -## Accès à OpenHands Cloud - -Pour commencer avec OpenHands Cloud, visitez [app.all-hands.dev](https://app.all-hands.dev). - -Vous serez invité à vous connecter avec votre compte GitHub ou GitLab : - -1. Après avoir lu et accepté les conditions d'utilisation, cliquez sur `Se connecter à GitHub` ou `Se connecter à GitLab`. -2. Examinez les permissions demandées par OpenHands et autorisez l'application. - - OpenHands nécessitera certaines permissions de votre compte. Pour en savoir plus sur ces permissions, - vous pouvez cliquer sur le lien `En savoir plus` sur la page d'autorisation. - -## Prochaines Étapes - -Une fois que vous avez connecté votre compte, vous pouvez : - -- [Installer l'Intégration GitHub](./github-installation.md) pour utiliser OpenHands avec vos dépôts GitHub -- [Installer l'Intégration GitLab](./gitlab-installation.md) pour utiliser OpenHands avec vos dépôts GitLab -- [Accéder à l'Interface Cloud](./cloud-ui.md) pour interagir avec l'interface web -- [Utiliser l'API Cloud](./cloud-api.md) pour interagir programmatiquement avec OpenHands -- [Configurer le Résolveur de Problèmes Cloud](./cloud-issue-resolver.md) pour automatiser les corrections de code et fournir une assistance intelligente diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/configuration-options.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/configuration-options.md deleted file mode 100644 index ae6820bd33..0000000000 --- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/configuration-options.md +++ /dev/null @@ -1,395 +0,0 @@ -# Options de Configuration - -:::note -Cette page présente toutes les options de configuration disponibles pour OpenHands, vous permettant de personnaliser son comportement et -de l'intégrer avec d'autres services. En Mode GUI, tous les paramètres appliqués via l'interface Paramètres auront la priorité. -::: - -## Configuration Principale - -Les options de configuration principales sont définies dans la section `[core]` du fichier `config.toml`. - -### Clés API -- `e2b_api_key` - - Type: `str` - - Défaut: `""` - - Description: Clé API pour E2B - -- `modal_api_token_id` - - Type: `str` - - Défaut: `""` - - Description: ID de token API pour Modal - -- `modal_api_token_secret` - - Type: `str` - - Défaut: `""` - - Description: Secret de token API pour Modal - -### Espace de travail -- `workspace_base` **(Déprécié)** - - Type: `str` - - Défaut: `"./workspace"` - - Description: Chemin de base pour l'espace de travail. **Déprécié: Utilisez `SANDBOX_VOLUMES` à la place.** - -- `cache_dir` - - Type: `str` - - Défaut: `"/tmp/cache"` - - Description: Chemin du répertoire de cache - -### Débogage et Journalisation -- `debug` - - Type: `bool` - - Défaut: `false` - - Description: Activer le débogage - -- `disable_color` - - Type: `bool` - - Défaut: `false` - - Description: Désactiver la couleur dans la sortie du terminal - -### Trajectoires -- `save_trajectory_path` - - Type: `str` - - Défaut: `"./trajectories"` - - Description: Chemin pour stocker les trajectoires (peut être un dossier ou un fichier). Si c'est un dossier, les trajectoires seront sauvegardées dans un fichier nommé avec l'ID de session et l'extension .json, dans ce dossier. - -- `replay_trajectory_path` - - Type: `str` - - Défaut: `""` - - Description: Chemin pour charger une trajectoire et la rejouer. Si fourni, doit être un chemin vers le fichier de trajectoire au format JSON. Les actions dans le fichier de trajectoire seront rejouées d'abord avant que toute instruction utilisateur ne soit exécutée. - -### Stockage de Fichiers -- `file_store_path` - - Type: `str` - - Défaut: `"/tmp/file_store"` - - Description: Chemin du stockage de fichiers - -- `file_store` - - Type: `str` - - Défaut: `"memory"` - - Description: Type de stockage de fichiers - -- `file_uploads_allowed_extensions` - - Type: `liste de str` - - Défaut: `[".*"]` - - Description: Liste des extensions de fichiers autorisées pour les téléchargements - -- `file_uploads_max_file_size_mb` - - Type: `int` - - Défaut: `0` - - Description: Taille maximale de fichier pour les téléchargements, en mégaoctets - -- `file_uploads_restrict_file_types` - - Type: `bool` - - Défaut: `false` - - Description: Restreindre les types de fichiers pour les téléchargements - -- `file_uploads_allowed_extensions` - - Type: `liste de str` - - Défaut: `[".*"]` - - Description: Liste des extensions de fichiers autorisées pour les téléchargements - -### Gestion des Tâches -- `max_budget_per_task` - - Type: `float` - - Défaut: `0.0` - - Description: Budget maximum par tâche (0.0 signifie pas de limite) - -- `max_iterations` - - Type: `int` - - Défaut: `100` - - Description: Nombre maximum d'itérations - -### Configuration du Sandbox -- `volumes` - - Type: `str` - - Défaut: `None` - - Description: Montages de volumes au format 'chemin_hôte:chemin_conteneur[:mode]', par ex. '/my/host/dir:/workspace:rw'. Plusieurs montages peuvent être spécifiés en utilisant des virgules, par ex. '/path1:/workspace/path1,/path2:/workspace/path2:ro' - -- `workspace_mount_path_in_sandbox` **(Déprécié)** - - Type: `str` - - Défaut: `"/workspace"` - - Description: Chemin pour monter l'espace de travail dans le sandbox. **Déprécié: Utilisez `SANDBOX_VOLUMES` à la place.** - -- `workspace_mount_path` **(Déprécié)** - - Type: `str` - - Défaut: `""` - - Description: Chemin pour monter l'espace de travail. **Déprécié: Utilisez `SANDBOX_VOLUMES` à la place.** - -- `workspace_mount_rewrite` **(Déprécié)** - - Type: `str` - - Défaut: `""` - - Description: Chemin pour réécrire le chemin de montage de l'espace de travail. Vous pouvez généralement ignorer cela, cela fait référence à des cas spéciaux d'exécution à l'intérieur d'un autre conteneur. **Déprécié: Utilisez `SANDBOX_VOLUMES` à la place.** - -### Divers -- `run_as_openhands` - - Type: `bool` - - Défaut: `true` - - Description: Exécuter en tant qu'OpenHands - -- `runtime` - - Type: `str` - - Défaut: `"docker"` - - Description: Environnement d'exécution - -- `default_agent` - - Type: `str` - - Défaut: `"CodeActAgent"` - - Description: Nom de l'agent par défaut - -- `jwt_secret` - - Type: `str` - - Défaut: `uuid.uuid4().hex` - - Description: Secret JWT pour l'authentification. Veuillez le définir avec votre propre valeur. - -## Configuration LLM - -Les options de configuration LLM (Large Language Model) sont définies dans la section `[llm]` du fichier `config.toml`. - -Pour les utiliser avec la commande docker, passez `-e LLM_