feat: update

.dockerignore

@@ -0,0 +1,12 @@
+**/node_modules
+**/dist
+**/.git
+**/.gitignore
+**/.vscode
+**/README.md
+**/LICENSE
+**/.env
+**/npm-debug.log
+**/yarn-debug.log
+**/yarn-error.log
+**/.pnpm-debug.log

.env.example

@@ -0,0 +1,6 @@
+OPENAI_API_KEY=
+OPENAI_API_BASE=
+OPENAI_MODEL=
+SILICON_API_KEY=
+SILICON_MODEL=
+InternLM_API_KEY=

.gitattributes

@@ -0,0 +1,4 @@
+*.png filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text
+*.gif filter=lfs diff=lfs merge=lfs -text
+*.mp4 filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,165 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[ciod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+.env
+temp

.pre-commit-config.yaml

@@ -0,0 +1,46 @@
+exclude: ^(tests/data|scripts|frontend/React)/
+repos:
+  - repo: https://github.com/PyCQA/flake8
+    rev: 7.0.0
+    hooks:
+      - id: flake8
+        args: ["--max-line-length=120"]
+  - repo: https://github.com/PyCQA/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+  - repo: https://github.com/pre-commit/mirrors-yapf
+    rev: v0.32.0
+    hooks:
+      - id: yapf
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: requirements-txt-fixer
+      - id: double-quote-string-fixer
+      - id: check-merge-conflict
+      - id: fix-encoding-pragma
+        args: ["--remove"]
+      - id: mixed-line-ending
+        args: ["--fix=lf"]
+  - repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.17
+    hooks:
+      - id: mdformat
+        args: ["--number"]
+        additional_dependencies:
+          - mdformat-openmmlab
+          - mdformat_frontmatter
+          - linkify-it-py
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.2.6
+    hooks:
+      - id: codespell
+  - repo: https://github.com/asottile/pyupgrade
+    rev: v3.15.0
+    hooks:
+      - id: pyupgrade
+        args: ["--py36-plus"]

.pylintrc

@@ -0,0 +1,428 @@
+# This Pylint rcfile contains a best-effort configuration to uphold the
+# best-practices and style described in the Google Python style guide:
+#   https://google.github.io/styleguide/pyguide.html
+#
+# Its canonical open-source location is:
+#   https://google.github.io/styleguide/pylintrc
+
+[MASTER]
+
+# Files or directories to be skipped. They should be base names, not paths.
+ignore=third_party,storage
+
+# Files or directories matching the regex patterns are skipped. The regex
+# matches against base names, not paths.
+ignore-patterns=
+
+# Pickle collected data for later comparisons.
+persistent=no
+
+# List of plugins (as comma separated values of python modules names) to load,
+# usually to register additional checkers.
+load-plugins=
+
+# Use multiple processes to speed up Pylint.
+jobs=4
+
+# Allow loading of arbitrary C extensions. Extensions are imported into the
+# active Python interpreter and may run arbitrary code.
+unsafe-load-any-extension=no
+
+
+[MESSAGES CONTROL]
+
+# Only show warnings with the listed confidence levels. Leave empty to show
+# all. Valid levels: HIGH, INFERENCE, INFERENCE_FAILURE, UNDEFINED
+confidence=
+
+# Enable the message, report, category or checker with the given id(s). You can
+# either give multiple identifier separated by comma (,) or put this option
+# multiple time (only on the command line, not in the configuration file where
+# it should appear only once). See also the "--disable" option for examples.
+#enable=
+
+# Disable the message, report, category or checker with the given id(s). You
+# can either give multiple identifiers separated by comma (,) or put this
+# option multiple times (only on the command line, not in the configuration
+# file where it should appear only once).You can also use "--disable=all" to
+# disable everything first and then reenable specific checks. For example, if
+# you want to run only the similarities checker, you can use "--disable=all
+# --enable=similarities". If you want to run only the classes checker, but have
+# no Warning level messages displayed, use"--disable=all --enable=classes
+# --disable=W"
+disable=abstract-method,
+        apply-builtin,
+        arguments-differ,
+        attribute-defined-outside-init,
+        backtick,
+        bad-option-value,
+        basestring-builtin,
+        buffer-builtin,
+        c-extension-no-member,
+        consider-using-enumerate,
+        cmp-builtin,
+        cmp-method,
+        coerce-builtin,
+        coerce-method,
+        delslice-method,
+        div-method,
+        duplicate-code,
+        eq-without-hash,
+        execfile-builtin,
+        file-builtin,
+        filter-builtin-not-iterating,
+        fixme,
+        getslice-method,
+        global-statement,
+        hex-method,
+        idiv-method,
+        implicit-str-concat,
+        import-error,
+        import-self,
+        import-star-module-level,
+        inconsistent-return-statements,
+        input-builtin,
+        intern-builtin,
+        invalid-str-codec,
+        locally-disabled,
+        long-builtin,
+        long-suffix,
+        map-builtin-not-iterating,
+        misplaced-comparison-constant,
+        missing-function-docstring,
+        metaclass-assignment,
+        next-method-called,
+        next-method-defined,
+        no-absolute-import,
+        no-else-break,
+        no-else-continue,
+        no-else-raise,
+        no-else-return,
+        no-init,  # added
+        no-member,
+        no-name-in-module,
+        no-self-use,
+        nonzero-method,
+        oct-method,
+        old-division,
+        old-ne-operator,
+        old-octal-literal,
+        old-raise-syntax,
+        parameter-unpacking,
+        print-statement,
+        raising-string,
+        range-builtin-not-iterating,
+        raw_input-builtin,
+        rdiv-method,
+        reduce-builtin,
+        relative-import,
+        reload-builtin,
+        round-builtin,
+        setslice-method,
+        signature-differs,
+        standarderror-builtin,
+        suppressed-message,
+        sys-max-int,
+        too-few-public-methods,
+        too-many-ancestors,
+        too-many-arguments,
+        too-many-boolean-expressions,
+        too-many-branches,
+        too-many-instance-attributes,
+        too-many-locals,
+        too-many-nested-blocks,
+        too-many-public-methods,
+        too-many-return-statements,
+        too-many-statements,
+        trailing-newlines,
+        unichr-builtin,
+        unicode-builtin,
+        unnecessary-pass,
+        unpacking-in-except,
+        useless-else-on-loop,
+        useless-object-inheritance,
+        useless-suppression,
+        using-cmp-argument,
+        wrong-import-order,
+        xrange-builtin,
+        zip-builtin-not-iterating,
+
+
+[REPORTS]
+
+# Set the output format. Available formats are text, parseable, colorized, msvs
+# (visual studio) and html. You can also give a reporter class, eg
+# mypackage.mymodule.MyReporterClass.
+output-format=colorized
+
+# Tells whether to display a full report or only the messages
+reports=no
+
+# Python expression which should return a note less than 10 (10 is the highest
+# note). You have access to the variables errors warning, statement which
+# respectively contain the number of errors / warnings messages and the total
+# number of statements analyzed. This is used by the global evaluation report
+# (RP0004).
+evaluation=10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)
+
+# Template used to display messages. This is a python new-style format string
+# used to format the message information. See doc for all details
+#msg-template=
+
+
+[BASIC]
+
+# Good variable names which should always be accepted, separated by a comma
+good-names=main,_
+
+# Bad variable names which should always be refused, separated by a comma
+bad-names=
+
+# Colon-delimited sets of names that determine each other's naming style when
+# the name regexes allow several styles.
+name-group=
+
+# Include a hint for the correct naming format with invalid-name
+include-naming-hint=no
+
+# List of decorators that produce properties, such as abc.abstractproperty. Add
+# to this list to register other decorators that produce valid properties.
+property-classes=abc.abstractproperty,cached_property.cached_property,cached_property.threaded_cached_property,cached_property.cached_property_with_ttl,cached_property.threaded_cached_property_with_ttl
+
+# Regular expression matching correct function names
+function-rgx=^(?:(?P<exempt>setUp|tearDown|setUpModule|tearDownModule)|(?P<camel_case>_?[A-Z][a-zA-Z0-9]*)|(?P<snake_case>_?[a-z][a-z0-9_]*))$
+
+# Regular expression matching correct variable names
+variable-rgx=^[a-z][a-z0-9_]*$
+
+# Regular expression matching correct constant names
+const-rgx=^(_?[A-Z][A-Z0-9_]*|__[a-z0-9_]+__|_?[a-z][a-z0-9_]*)$
+
+# Regular expression matching correct attribute names
+attr-rgx=^_{0,2}[a-z][a-z0-9_]*$
+
+# Regular expression matching correct argument names
+argument-rgx=^[a-z][a-z0-9_]*$
+
+# Regular expression matching correct class attribute names
+class-attribute-rgx=^(_?[A-Z][A-Z0-9_]*|__[a-z0-9_]+__|_?[a-z][a-z0-9_]*)$
+
+# Regular expression matching correct inline iteration names
+inlinevar-rgx=^[a-z][a-z0-9_]*$
+
+# Regular expression matching correct class names
+class-rgx=^_?[A-Z][a-zA-Z0-9]*$
+
+# Regular expression matching correct module names
+module-rgx=^(_?[a-z][a-z0-9_]*|__init__)$
+
+# Regular expression matching correct method names
+method-rgx=(?x)^(?:(?P<exempt>_[a-z0-9_]+__|runTest|setUp|tearDown|setUpTestCase|tearDownTestCase|setupSelf|tearDownClass|setUpClass|(test|assert)_*[A-Z0-9][a-zA-Z0-9_]*|next)|(?P<camel_case>_{0,2}[A-Z][a-zA-Z0-9_]*)|(?P<snake_case>_{0,2}[a-z][a-z0-9_]*))$
+
+# Regular expression which should only match function or class names that do
+# not require a docstring.
+no-docstring-rgx=(__.*__|main|test.*|.*test|.*Test)$
+
+# Minimum line length for functions/classes that require docstrings, shorter
+# ones are exempt.
+docstring-min-length=10
+
+
+[TYPECHECK]
+
+# List of decorators that produce context managers, such as
+# contextlib.contextmanager. Add to this list to register other decorators that
+# produce valid context managers.
+contextmanager-decorators=contextlib.contextmanager,contextlib2.contextmanager
+
+# Tells whether missing members accessed in mixin class should be ignored. A
+# mixin class is detected if its name ends with "mixin" (case insensitive).
+ignore-mixin-members=yes
+
+# List of module names for which member attributes should not be checked
+# (useful for modules/projects where namespaces are manipulated during runtime
+# and thus existing member attributes cannot be deduced by static analysis. It
+# supports qualified module names, as well as Unix pattern matching.
+ignored-modules=
+
+# List of class names for which member attributes should not be checked (useful
+# for classes with dynamically set attributes). This supports the use of
+# qualified names.
+ignored-classes=optparse.Values,thread._local,_thread._local
+
+# List of members which are set dynamically and missed by pylint inference
+# system, and so shouldn't trigger E1101 when accessed. Python regular
+# expressions are accepted.
+generated-members=
+
+
+[FORMAT]
+
+# Maximum number of characters on a single line.
+max-line-length=120
+
+# TODO(https://github.com/PyCQA/pylint/issues/3352): Direct pylint to exempt
+# lines made too long by directives to pytype.
+
+# Regexp for a line that is allowed to be longer than the limit.
+ignore-long-lines=(?x)(
+  ^\s*(\#\ )?<?https?://\S+>?$|
+  ^\s*(from\s+\S+\s+)?import\s+.+$)
+
+# Allow the body of an if to be on the same line as the test if there is no
+# else.
+single-line-if-stmt=yes
+
+# Maximum number of lines in a module
+max-module-lines=99999
+
+# String used as indentation unit.  The internal Google style guide mandates 2
+# spaces.  Google's externaly-published style guide says 4, consistent with
+# PEP 8.  Here, we use 2 spaces, for conformity with many open-sourced Google
+# projects (like TensorFlow).
+indent-string='    '
+
+# Number of spaces of indent required inside a hanging  or continued line.
+indent-after-paren=4
+
+# Expected format of line ending, e.g. empty (any line ending), LF or CRLF.
+expected-line-ending-format=
+
+
+[MISCELLANEOUS]
+
+# List of note tags to take in consideration, separated by a comma.
+notes=TODO
+
+
+[STRING]
+
+# This flag controls whether inconsistent-quotes generates a warning when the
+# character used as a quote delimiter is used inconsistently within a module.
+check-quote-consistency=yes
+
+
+[VARIABLES]
+
+# Tells whether we should check for unused import in __init__ files.
+init-import=no
+
+# A regular expression matching the name of dummy variables (i.e. expectedly
+# not used).
+dummy-variables-rgx=^\*{0,2}(_$|unused_|dummy_)
+
+# List of additional names supposed to be defined in builtins. Remember that
+# you should avoid to define new builtins when possible.
+additional-builtins=
+
+# List of strings which can identify a callback function by name. A callback
+# name must start or end with one of those strings.
+callbacks=cb_,_cb
+
+# List of qualified module names which can have objects that can redefine
+# builtins.
+redefining-builtins-modules=six,six.moves,past.builtins,future.builtins,functools
+
+
+[LOGGING]
+
+# Logging modules to check that the string format arguments are in logging
+# function parameter format
+logging-modules=logging,absl.logging,tensorflow.io.logging
+
+
+[SIMILARITIES]
+
+# Minimum lines number of a similarity.
+min-similarity-lines=4
+
+# Ignore comments when computing similarities.
+ignore-comments=yes
+
+# Ignore docstrings when computing similarities.
+ignore-docstrings=yes
+
+# Ignore imports when computing similarities.
+ignore-imports=no
+
+
+[SPELLING]
+
+# Spelling dictionary name. Available dictionaries: none. To make it working
+# install python-enchant package.
+spelling-dict=
+
+# List of comma separated words that should not be checked.
+spelling-ignore-words=
+
+# A path to a file that contains private dictionary; one word per line.
+spelling-private-dict-file=
+
+# Tells whether to store unknown words to indicated private dictionary in
+# --spelling-private-dict-file option instead of raising a message.
+spelling-store-unknown-words=no
+
+
+[IMPORTS]
+
+# Deprecated modules which should not be used, separated by a comma
+deprecated-modules=regsub,
+                   TERMIOS,
+                   Bastion,
+                   rexec,
+                   sets
+
+# Create a graph of every (i.e. internal and external) dependencies in the
+# given file (report RP0402 must not be disabled)
+import-graph=
+
+# Create a graph of external dependencies in the given file (report RP0402 must
+# not be disabled)
+ext-import-graph=
+
+# Create a graph of internal dependencies in the given file (report RP0402 must
+# not be disabled)
+int-import-graph=
+
+# Force import order to recognize a module as part of the standard
+# compatibility libraries.
+known-standard-library=
+
+# Force import order to recognize a module as part of a third party library.
+known-third-party=enchant, absl
+
+# Analyse import fallback blocks. This can be used to support both Python 2 and
+# 3 compatible code, which means that the block might have code that exists
+# only in one or another interpreter, leading to false positives when analysed.
+analyse-fallback-blocks=no
+
+
+[CLASSES]
+
+# List of method names used to declare (i.e. assign) instance attributes.
+defining-attr-methods=__init__,
+                      __new__,
+                      setUp
+
+# List of member names, which should be excluded from the protected access
+# warning.
+exclude-protected=_asdict,
+                  _fields,
+                  _replace,
+                  _source,
+                  _make
+
+# List of valid names for the first argument in a class method.
+valid-classmethod-first-arg=cls,
+                            class_
+
+# List of valid names for the first argument in a metaclass class method.
+valid-metaclass-classmethod-first-arg=mcs
+
+
+[EXCEPTIONS]
+
+# Exceptions that will emit a warning when being caught. Defaults to
+# "Exception"
+overgeneral-exceptions=builtins.BaseException,
+                       builtins.Exception

Dockerfile

@@ -0,0 +1,27 @@
+FROM continuumio/miniconda3
+
+ARG OPENAI_API_KEY
+ENV OPENAI_API_KEY=${OPENAI_API_KEY}
+
+ARG BING_API_KEY
+ENV BING_API_KEY=${BING_API_KEY}
+
+# 设置环境变量
+ENV PATH=/opt/conda/bin:$PATH
+
+# 克隆git仓库
+RUN git clone https://github.com/InternLM/MindSearch.git /app
+
+WORKDIR /app
+
+# 创建并激活 fastapi 环境，并安装依赖包
+RUN conda create --name fastapi python=3.10 -y && \
+    conda run -n fastapi pip install -r requirements.txt && \
+    conda clean --all -f -y
+
+# 暴露 FastAPI 默认端口
+EXPOSE 8000
+
+# 启动 FastAPI 服务
+ENTRYPOINT ["conda", "run", "--no-capture-output", "-n", "fastapi"]
+CMD ["python3", "-m", "mindsearch.app", "--asy", "--host", "0.0.0.0", "--port", "8002"]

LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2024 Shanghai AI Laboratory.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

README.md

@@ -0,0 +1,171 @@
+
+
+<div id="top"></div>
+
+<div align="center">
+
+<img src="assets/logo.svg" style="width: 50%; height: auto;">
+
+[📃 Paper](https://arxiv.org/abs/2407.20183) | [💻 Demo](https://internlm-chat.intern-ai.org.cn/)
+
+English | [简体中文](README_zh-CN.md)
+
+<https://github.com/user-attachments/assets/44ffe4b9-be26-4b93-a77b-02fed16e33fe>
+
+</div>
+</p>
+
+## ✨ MindSearch: Mimicking Human Minds Elicits Deep AI Searcher
+
+## 📅 Changelog
+
+- 2024/11/05: 🥳 MindSearch is now deployed on Puyu! 👉 [Try it](https://internlm-chat.intern-ai.org.cn/) 👈
+  -  Refactored the agent module based on [Lagent v0.5](https://github.com/InternLM/lagent) for better performance in concurrency.
+  -  Improved the UI to embody the simultaneous multi-query search.
+
+
+## ⚽️ Build Your Own MindSearch
+
+### Step1: Dependencies Installation
+
+```bash
+git clone https://github.com/InternLM/MindSearch
+cd MindSearch
+pip install -r requirements.txt
+```
+
+### Step2: Setup Environment Variables
+
+Before setting up the API, you need to configure environment variables. Rename the `.env.example` file to `.env` and fill in the required values.
+
+```bash
+mv .env.example .env
+# Open .env and add your keys and model configurations
+```
+
+### Step3: Setup MindSearch API
+
+Setup FastAPI Server.
+
+```bash
+python -m mindsearch.app --lang en --model_format internlm_silicon --search_engine DuckDuckGoSearch --asy 
+```
+
+- `--lang`: language of the model, `en` for English and `cn` for Chinese.
+- `--model_format`: format of the model.
+  - `internlm_server` for InternLM2.5-7b-chat with local server. (InternLM2.5-7b-chat has been better optimized for Chinese.)
+  - `gpt4` for GPT4.
+    if you want to use other models, please modify [models](./mindsearch/agent/models.py)
+- `--search_engine`: Search engine.
+  - `DuckDuckGoSearch` for search engine for DuckDuckGo.
+  - `BingSearch` for Bing search engine.
+  - `BraveSearch` for Brave search web api engine.
+  - `GoogleSearch` for Google Serper web search api engine.
+  - `TencentSearch` for Tencent search api engine.
+  
+  Please set your Web Search engine API key as the `WEB_SEARCH_API_KEY` environment variable unless you are using `DuckDuckGo`, or `TencentSearch` that requires secret id as `TENCENT_SEARCH_SECRET_ID` and secret key as `TENCENT_SEARCH_SECRET_KEY`.
+- `--asy`: deploy asynchronous agents.
+
+### Step4: Setup MindSearch Frontend
+
+Providing following frontend interfaces,
+
+- React
+
+First configurate the backend URL for Vite proxy.
+
+```bash
+HOST="127.0.0.1"  # modify as you need
+PORT=8002
+sed -i -r "s/target:\s*\"\"/target: \"${HOST}:${PORT}\"/" frontend/React/vite.config.ts
+```
+
+```bash
+# Install Node.js and npm
+# for Ubuntu
+sudo apt install nodejs npm
+
+# for windows
+# download from https://nodejs.org/zh-cn/download/prebuilt-installer
+
+# Install dependencies
+
+cd frontend/React
+npm install
+npm start
+```
+
+Details can be found in [React](./frontend/React/README.md)
+
+- Gradio
+
+```bash
+python frontend/mindsearch_gradio.py
+```
+
+- Streamlit
+
+```bash
+streamlit run frontend/mindsearch_streamlit.py
+```
+
+## 🌐 Change Web Search API
+
+To use a different type of web search API, modify the `searcher_type` attribute in the `searcher_cfg` located in `mindsearch/agent/__init__.py`. Currently supported web search APIs include:
+
+- `GoogleSearch`
+- `DuckDuckGoSearch`
+- `BraveSearch`
+- `BingSearch`
+- `TencentSearch`
+
+For example, to change to the Brave Search API, you would configure it as follows:
+
+```python
+BingBrowser(
+    searcher_type='BraveSearch',
+    topk=2,
+    api_key=os.environ.get('BRAVE_API_KEY', 'YOUR BRAVE API')
+)
+```
+
+## 🐞 Using the Backend Without Frontend
+
+For users who prefer to interact with the backend directly, use the `backend_example.py` script. This script demonstrates how to send a query to the backend and process the response.
+
+```bash
+python backend_example.py
+```
+
+Make sure you have set up the environment variables and the backend is running before executing the script.
+
+## 🐞 Debug Locally
+
+```bash
+python -m mindsearch.terminal
+```
+
+## 📝 License
+
+This project is released under the [Apache 2.0 license](LICENSE).
+
+## Citation
+
+If you find this project useful in your research, please consider cite:
+
+```
+@article{chen2024mindsearch,
+  title={MindSearch: Mimicking Human Minds Elicits Deep AI Searcher},
+  author={Chen, Zehui and Liu, Kuikun and Wang, Qiuchen and Liu, Jiangning and Zhang, Wenwei and Chen, Kai and Zhao, Feng},
+  journal={arXiv preprint arXiv:2407.20183},
+  year={2024}
+}
+```
+
+## Our Projects
+
+Explore our additional research on large language models, focusing on LLM agents.
+
+- [Lagent](https://github.com/InternLM/lagent): A lightweight framework for building LLM-based agents
+- [AgentFLAN](https://github.com/InternLM/Agent-FLAN): An innovative approach for constructing and training with high-quality agent datasets (ACL 2024 Findings)
+- [T-Eval](https://github.com/open-compass/T-Eval): A Fine-grained tool utilization evaluation benchmark (ACL 2024)

README_zh-CN.md

@@ -0,0 +1,140 @@
+<div id="top"></div>
+
+<div align="center">
+
+<img src="assets/logo.svg" style="width: 50%; height: auto;">
+
+[📃 Paper](https://arxiv.org/abs/2407.20183) | [💻 浦语入口](https://internlm-chat.intern-ai.org.cn/)
+
+[English](README.md) | 简体中文
+
+<https://github.com/user-attachments/assets/b4312e9c-5b40-43e5-8c69-929c373e4965>
+
+</div>
+</p>
+
+## ✨ MindSearch: Mimicking Human Minds Elicits Deep AI Searcher
+
+MindSearch 是一个开源的 AI 搜索引擎框架，具有与 Perplexity.ai Pro 相同的性能。您可以轻松部署它来构建您自己的搜索引擎，可以使用闭源 LLM（如 GPT、Claude）或开源 LLM（[InternLM2.5 系列模型](https://huggingface.co/internlm/internlm2_5-7b-chat)经过专门优化，能够在 MindSearch 框架中提供卓越的性能；其他开源模型没做过具体测试）。其拥有以下特性：
+
+- 🤔 **任何想知道的问题**：MindSearch 通过搜索解决你在生活中遇到的各种问题
+- 📚 **深度知识探索**：MindSearch 通过数百网页的浏览，提供更广泛、深层次的答案
+- 🔍 **透明的解决方案路径**：MindSearch 提供了思考路径、搜索关键词等完整的内容，提高回复的可信度和可用性。
+- 💻 **多种用户界面**：为用户提供各种接口，包括 React、Gradio、Streamlit 和本地调试。根据需要选择任意类型。
+- 🧠 **动态图构建过程**：MindSearch 将用户查询分解为图中的子问题节点，并根据 WebSearcher 的搜索结果逐步扩展图。
+
+<div align="center">
+
+<img src="assets/teaser.gif">
+
+</div>
+
+## ⚡️ MindSearch VS 其他 AI 搜索引擎
+
+在深度、广度和生成响应的准确性三个方面，对 ChatGPT-Web、Perplexity.ai（Pro）和 MindSearch 的表现进行比较。评估结果基于 100 个由人类专家精心设计的现实问题，并由 5 位专家进行评分\*。
+
+<div align="center">
+<img src="assets/mindsearch_openset.png" width="90%">
+</div>
+* 所有实验均在 2024 年 7 月 7 日之前完成。
+
+## ⚽️ 构建您自己的 MindSearch
+
+### 步骤1: 依赖安装
+
+```bash
+pip install -r requirements.txt
+```
+
+### 步骤2: 启动 MindSearch API
+
+启动 FastAPI 服务器
+
+```bash
+python -m mindsearch.app --lang en --model_format internlm_server --search_engine DuckDuckGoSearch
+```
+
+- `--lang`: 模型的语言，`en` 为英语，`cn` 为中文。
+- `--model_format`: 模型的格式。
+  - `internlm_server` 为 InternLM2.5-7b-chat 本地服务器。
+  - `gpt4` 为 GPT4。
+    如果您想使用其他模型，请修改 [models](./mindsearch/agent/models.py)
+- `--search_engine`: 搜索引擎。
+  - `DuckDuckGoSearch` 为 DuckDuckGo 搜索引擎。
+  - `BingSearch` 为 Bing 搜索引擎。
+  - `BraveSearch` 为 Brave 搜索引擎。
+  - `GoogleSearch` 为 Google Serper 搜索引擎。
+  - `TencentSearch` 为 Tencent 搜索引擎。
+    
+  请将 DuckDuckGo 和 Tencent 以外的网页搜索引擎 API 密钥设置为 `WEB_SEARCH_API_KEY` 环境变量。如果使用 DuckDuckGo，则无需设置；如果使用 Tencent，请设置 `TENCENT_SEARCH_SECRET_ID` 和 `TENCENT_SEARCH_SECRET_KEY`。
+ 
+### 步骤3: 启动 MindSearch 前端
+
+提供以下几种前端界面：
+
+- React
+
+首先配置Vite的API代理，指定实际后端URL
+
+```bash
+HOST="127.0.0.1"
+PORT=8002
+sed -i -r "s/target:\s*\"\"/target: \"${HOST}:${PORT}\"/" frontend/React/vite.config.ts
+```
+
+```bash
+# 安装 Node.js 和 npm
+# 对于 Ubuntu
+sudo apt install nodejs npm
+# 对于 Windows
+# 从 https://nodejs.org/zh-cn/download/prebuilt-installer 下载
+
+cd frontend/React
+npm install
+npm start
+```
+
+更多细节请参考 [React](./frontend/React/README.md)
+
+- Gradio
+
+```bash
+python frontend/mindsearch_gradio.py
+```
+
+- Streamlit
+
+```bash
+streamlit run frontend/mindsearch_streamlit.py
+```
+
+## 🐞 本地调试
+
+```bash
+python mindsearch/terminal.py
+```
+
+## 📝 许可证
+
+该项目按照 [Apache 2.0 许可证](LICENSE) 发行。
+
+## 学术引用
+
+如果此项目对您的研究有帮助，请参考如下方式进行引用：
+
+```
+@article{chen2024mindsearch,
+  title={MindSearch: Mimicking Human Minds Elicits Deep AI Searcher},
+  author={Chen, Zehui and Liu, Kuikun and Wang, Qiuchen and Liu, Jiangning and Zhang, Wenwei and Chen, Kai and Zhao, Feng},
+  journal={arXiv preprint arXiv:2407.20183},
+  year={2024}
+}
+```
+
+## 相关项目
+
+关注我们其他在大语言模型上的一些探索，主要为LLM智能体方向。
+
+- [Lagent](https://github.com/InternLM/lagent): 一个轻便简洁的大语言模型智能体框架
+- [AgentFLAN](https://github.com/InternLM/Agent-FLAN): 一套构建高质量智能体语料和训练模型的方法 (ACL 2024 Findings)
+- [T-Eval](https://github.com/open-compass/T-Eval): 一个细粒度评估LLM调用工具能力的评测及 (ACL 2024)

app.py

@@ -0,0 +1,318 @@
+import json
+import mimetypes
+import os
+import sys
+import tempfile
+
+import gradio as gr
+import requests
+
+sys.path.insert(0, os.path.dirname(__file__))
+
+import schemdraw
+from frontend.gradio_agentchatbot.agentchatbot import AgentChatbot
+from frontend.gradio_agentchatbot.utils import ChatFileMessage, ChatMessage, ThoughtMetadata
+from lagent.schema import AgentStatusCode
+from schemdraw import flow
+
+
+import os
+
+os.system("pip install tenacity")
+os.system("python -m mindsearch.app --lang en --model_format internlm_silicon --search_engine DuckDuckGoSearch &")
+
+
+print('MindSearch is running on http://')
+
+PLANNER_HISTORY = []
+SEARCHER_HISTORY = []
+
+
+def create_search_graph(adjacency_list: dict):
+    import matplotlib.pyplot as plt
+
+    plt.rcParams["font.sans-serif"] = ["SimHei"]
+
+    with schemdraw.Drawing(fontsize=10, unit=1) as graph:
+        node_pos, nodes, edges = {}, {}, []
+        if "root" in adjacency_list:
+            queue, layer, response_level = ["root"], 0, 0
+            while queue:
+                layer_len = len(queue)
+                for i in range(layer_len):
+                    node_name = queue.pop(0)
+                    node_pos[node_name] = (layer * 5, -i * 3)
+                    for item in adjacency_list[node_name]:
+                        if item["name"] == "response":
+                            response_level = max(response_level, (layer + 1) * 5)
+                        else:
+                            queue.append(item["name"])
+                        edges.append((node_name, item["name"]))
+                layer += 1
+            for node_name, (x, y) in node_pos.items():
+                if node_name == "root":
+                    node = flow.Terminal().label(node_name).at((x, y)).color("pink")
+                else:
+                    node = flow.RoundBox(w=3.5, h=1.75).label(node_name).at((x, y)).color("teal")
+                nodes[node_name] = node
+            if response_level:
+                response_node = (
+                    flow.Terminal().label("response").at((response_level, 0)).color("orange")
+                )
+                nodes["response"] = response_node
+            for start, end in edges:
+                flow.Arc3(arrow="->").linestyle("--" if end == "response" else "-").at(
+                    nodes[start].E
+                ).to(nodes[end].W).color("grey" if end == "response" else "lightblue")
+    return graph
+
+
+def draw_search_graph(adjacency_list: dict, suffix=".png", dpi=360) -> str:
+    g = create_search_graph(adjacency_list)
+    path = tempfile.mktemp(suffix=suffix)
+    g.save(path, dpi=dpi)
+    return path
+
+
+def rst_mem():
+    """Reset the chatbot memory."""
+    if PLANNER_HISTORY:
+        PLANNER_HISTORY.clear()
+    return [], [], 0
+
+
+def format_response(gr_history, message, response, idx=-1):
+    if idx < 0:
+        idx = len(gr_history) + idx
+    if message["stream_state"] == AgentStatusCode.STREAM_ING:
+        gr_history[idx].content = response
+    elif message["stream_state"] == AgentStatusCode.CODING:
+        if gr_history[idx].thought_metadata.tool_name is None:
+            gr_history[idx].content = gr_history[idx].content.split("<|action_start|>")[0]
+            gr_history.insert(
+                idx + 1,
+                ChatMessage(
+                    role="assistant",
+                    content=response,
+                    thought_metadata=ThoughtMetadata(tool_name="🖥️ Code Interpreter"),
+                ),
+            )
+        else:
+            gr_history[idx].content = response
+    elif message["stream_state"] == AgentStatusCode.PLUGIN_START:
+        if isinstance(response, dict):
+            response = json.dumps(response, ensure_ascii=False, indent=4)
+        if gr_history[idx].thought_metadata.tool_name is None:
+            gr_history[idx].content = gr_history[idx].content.split("<|action_start|>")[0]
+            gr_history.insert(
+                idx + 1,
+                ChatMessage(
+                    role="assistant",
+                    content="```json\n" + response,
+                    thought_metadata=ThoughtMetadata(tool_name="🌐 Web Browser"),
+                ),
+            )
+        else:
+            gr_history[idx].content = "```json\n" + response
+    elif message["stream_state"] == AgentStatusCode.PLUGIN_END and isinstance(response, dict):
+        gr_history[idx].content = (
+            f"```json\n{json.dumps(response, ensure_ascii=False, indent=4)}\n```"
+        )
+    elif message["stream_state"] in [AgentStatusCode.CODE_RETURN, AgentStatusCode.PLUGIN_RETURN]:
+        try:
+            content = json.loads(message["content"])
+        except json.decoder.JSONDecodeError:
+            content = message["content"]
+        if gr_history[idx].thought_metadata.tool_name:
+            gr_history.insert(
+                idx + 1,
+                ChatMessage(
+                    role="assistant",
+                    content=(
+                        content
+                        if isinstance(content, str)
+                        else f"\n```json\n{json.dumps(content, ensure_ascii=False, indent=4)}\n```\n"
+                    ),
+                    thought_metadata=ThoughtMetadata(tool_name="Execution"),
+                ),
+            )
+            gr_history.insert(idx + 2, ChatMessage(role="assistant", content=""))
+
+
+def predict(history_planner, history_searcher, node_cnt):
+
+    def streaming(raw_response):
+        for chunk in raw_response.iter_lines(
+            chunk_size=8192, decode_unicode=False, delimiter=b"\n"
+        ):
+            if chunk:
+                decoded = chunk.decode("utf-8")
+                if decoded == "\r":
+                    continue
+                if decoded[:6] == "data: ":
+                    decoded = decoded[6:]
+                elif decoded.startswith(": ping - "):
+                    continue
+                response = json.loads(decoded)
+                yield (
+                    response["current_node"],
+                    (
+                        response["response"]["formatted"]["node"][response["current_node"]]
+                        if response["current_node"]
+                        else response["response"]
+                    ),
+                    response["response"]["formatted"]["adjacency_list"],
+                )
+
+    global PLANNER_HISTORY
+    PLANNER_HISTORY.extend(history_planner[-3:])
+    search_graph_msg = history_planner[-1]
+
+    url = "http://localhost:8002/solve"
+    data = {"inputs": PLANNER_HISTORY[-3].content}
+    raw_response = requests.post(url, json=data, timeout=60, stream=True)
+
+    node_id2msg_idx = {}
+    for resp in streaming(raw_response):
+        node_name, agent_message, adjacency_list = resp
+        dedup_nodes = set(adjacency_list) | {
+            val["name"] for vals in adjacency_list.values() for val in vals
+        }
+        if dedup_nodes and len(dedup_nodes) != node_cnt:
+            node_cnt = len(dedup_nodes)
+            graph_path = draw_search_graph(adjacency_list)
+            search_graph_msg.file.path = graph_path
+            search_graph_msg.file.mime_type = mimetypes.guess_type(graph_path)[0]
+        if node_name:
+            if node_name in ["root", "response"]:
+                continue
+            node_id = f'【{node_name}】{agent_message["content"]}'
+            agent_message = agent_message["response"]
+            response = (
+                agent_message["formatted"]["action"]
+                if agent_message["stream_state"]
+                in [AgentStatusCode.PLUGIN_START, AgentStatusCode.PLUGIN_END]
+                else agent_message["formatted"] and agent_message["formatted"].get("thought")
+            )
+            if node_id not in node_id2msg_idx:
+                node_id2msg_idx[node_id] = len(history_searcher) + 1
+                history_searcher.append(ChatMessage(role="user", content=node_id))
+                history_searcher.append(ChatMessage(role="assistant", content=""))
+            offset = len(history_searcher)
+            format_response(history_searcher, agent_message, response, node_id2msg_idx[node_id])
+            flag, incr = False, len(history_searcher) - offset
+            for key, value in node_id2msg_idx.items():
+                if flag or key == node_id:
+                    node_id2msg_idx[key] = value + incr
+                    if not flag:
+                        flag = True
+            yield history_planner, history_searcher, node_cnt
+        else:
+            response = (
+                agent_message["formatted"]["action"]
+                if agent_message["stream_state"]
+                in [AgentStatusCode.CODING, AgentStatusCode.CODE_END]
+                else agent_message["formatted"] and agent_message["formatted"].get("thought")
+            )
+            format_response(history_planner, agent_message, response, -2)
+            if agent_message["stream_state"] == AgentStatusCode.END:
+                PLANNER_HISTORY = history_planner
+            yield history_planner, history_searcher, node_cnt
+    return history_planner, history_searcher, node_cnt
+
+
+with gr.Blocks(css=os.path.join(os.path.dirname(__file__), "css", "gradio_front.css")) as demo:
+    with gr.Column(elem_classes="chat-box"):
+        gr.HTML("""<h1 align="center">MindSearch Gradio Demo</h1>""")
+        gr.HTML(
+            """<p style="text-align: center; font-family: Arial, sans-serif;">
+                MindSearch is an open-source AI Search Engine Framework with Perplexity.ai Pro performance.
+                You can deploy your own Perplexity.ai-style search engine using either
+                closed-source LLMs (GPT, Claude)
+                or open-source LLMs (InternLM2.5-7b-chat).</p> """
+        )
+        gr.HTML(
+            """
+        <div style="text-align: center; font-size: 16px;">
+        <a href="https://github.com/InternLM/MindSearch" style="margin-right: 15px;
+         text-decoration: none; color: #4A90E2;" target="_blank">🔗 GitHub</a>
+        <a href="https://arxiv.org/abs/2407.20183" style="margin-right: 15px;
+         text-decoration: none; color: #4A90E2;" target="_blank">📄 Arxiv</a>
+        <a href="https://huggingface.co/papers/2407.20183" style="margin-right:
+         15px; text-decoration: none; color: #4A90E2;" target="_blank">📚 Hugging Face Papers</a>
+        <a href="https://huggingface.co/spaces/internlm/MindSearch"
+         style="text-decoration: none; color: #4A90E2;" target="_blank">🤗 Hugging Face Demo</a>
+        </div>"""
+        )
+    gr.HTML(
+        """
+       <h1 align='right'><img
+        src=
+        'https://raw.githubusercontent.com/InternLM/MindSearch/98fd84d566fe9e3adc5028727f72f2944098fd05/assets/logo.svg'
+         alt='MindSearch Logo1' class="logo" width="200"></h1> """
+    )
+    node_count = gr.State(0)
+    with gr.Row():
+        planner = AgentChatbot(
+            label="planner",
+            height=600,
+            show_label=True,
+            show_copy_button=True,
+            bubble_full_width=False,
+            render_markdown=True,
+            elem_classes="chatbot-container",
+        )
+        searcher = AgentChatbot(
+            label="searcher",
+            height=600,
+            show_label=True,
+            show_copy_button=True,
+            bubble_full_width=False,
+            render_markdown=True,
+            elem_classes="chatbot-container",
+        )
+    with gr.Row(elem_classes="chat-box"):
+        # Text input area
+        user_input = gr.Textbox(
+            show_label=False,
+            placeholder="Type your message...",
+            lines=1,
+            container=False,
+            elem_classes="editor",
+            scale=4,
+        )
+        # Buttons (now in the same Row)
+        submitBtn = gr.Button("submit", variant="primary", elem_classes="toolbarButton", scale=1)
+        clearBtn = gr.Button("clear", variant="secondary", elem_classes="toolbarButton", scale=1)
+    with gr.Row(elem_classes="examples-container"):
+        examples_component = gr.Examples(
+            [
+                ["Find legal precedents in contract law."],
+                ["What are the top 10 e-commerce websites?"],
+                ["Generate a report on global climate change."],
+            ],
+            inputs=user_input,
+            label="Try these examples:",
+        )
+
+    def user(query, history):
+        history.append(ChatMessage(role="user", content=query))
+        history.append(ChatMessage(role="assistant", content=""))
+        graph_path = draw_search_graph({"root": []})
+        history.append(
+            ChatFileMessage(
+                role="assistant",
+                file=gr.FileData(path=graph_path, mime_type=mimetypes.guess_type(graph_path)[0]),
+            )
+        )
+        return "", history
+
+    submitBtn.click(user, [user_input, planner], [user_input, planner], queue=False).then(
+        predict,
+        [planner, searcher, node_count],
+        [planner, searcher, node_count],
+    )
+    clearBtn.click(rst_mem, None, [planner, searcher, node_count], queue=False)
+
+demo.queue()
+demo.launch(server_name="127.0.0.1", inbrowser=True, share=False)

backend_example.py

@@ -0,0 +1,37 @@
+import json
+
+import requests
+
+# Define the backend URL
+url = "http://localhost:8002/solve"
+headers = {"Content-Type": "application/json"}
+
+
+# Function to send a query to the backend and get the response
+def get_response(query):
+    # Prepare the input data
+    data = {"inputs": query}
+
+    # Send the request to the backend
+    response = requests.post(url, headers=headers, data=json.dumps(data), timeout=20, stream=True)
+
+    # Process the streaming response
+    for chunk in response.iter_lines(chunk_size=8192, decode_unicode=False, delimiter=b"\n"):
+        if chunk:
+            decoded = chunk.decode("utf-8")
+            if decoded == "\r":
+                continue
+            if decoded[:6] == "data: ":
+                decoded = decoded[6:]
+            elif decoded.startswith(": ping - "):
+                continue
+            response_data = json.loads(decoded)
+            agent_return = response_data["response"]
+            node_name = response_data["current_node"]
+            print(f"Node: {node_name}, Response: {agent_return['response']}")
+
+
+# Example usage
+if __name__ == "__main__":
+    query = "What is the weather like today in New York?"
+    get_response(query)

docker/README.md

@@ -0,0 +1,125 @@
+# MSDL (MindSearch Docker Launcher) User Guide
+
+English | [简体中文](README_zh-CN.md)
+
+## Introduction
+
+MSDL (MindSearch Docker Launcher) is a command-line tool designed to simplify the deployment process of MindSearch. It helps users configure and launch the Docker environment for MindSearch through an interactive interface, reducing the complexity of deployment. MSDL primarily serves as a scaffold for deploying containers and does not involve optimization of MindSearch's core logic.
+
+## Prerequisites
+
+- Python 3.7 or higher
+- Docker (Docker Compose included; most newer Docker versions have it integrated)
+- Git (for cloning the repository)
+- Stable internet connection
+- Sufficient disk space (required space varies depending on the selected deployment option)
+
+## Installation Steps
+
+1. Clone the MindSearch repository:
+   ```bash
+   git clone https://github.com/InternLM/MindSearch.git # If you have already cloned the repository, you can skip this step.
+   cd MindSearch/docker
+   ```
+
+2. Install MSDL:
+   ```bash
+   pip install -e .
+   ```
+
+## Usage
+
+After installation, you can run the MSDL command from any directory:
+
+```bash
+msdl
+```
+
+Follow the interactive prompts for configuration:
+- Choose the language for the Agent (Chinese or English; this only affects the language of prompts).
+- Select the model deployment type (local model or cloud model).
+- Choose the model format:
+  - Currently, only `internlm_silicon` works properly for cloud models.
+  - For local models, only `internlm_server` has passed tests and runs correctly.
+- Enter the necessary API keys (e.g., SILICON_API_KEY).
+
+MSDL will automatically perform the following actions:
+- Copy and configure the necessary Dockerfile and docker-compose.yaml files.
+- Build Docker images.
+- Launch Docker containers.
+
+## Deployment Options Comparison
+
+### Cloud Model Deployment (Recommended)
+
+**Advantages**:
+- Lightweight deployment with minimal disk usage (frontend around 510MB, backend around 839MB).
+- No need for high-performance hardware.
+- Easy to deploy and maintain.
+- You can freely use the `internlm/internlm2_5-7b-chat` model via SiliconCloud.
+- High concurrency, fast inference speed.
+
+**Instructions**:
+- Select the "Cloud Model" option.
+- Choose "internlm_silicon" as the model format.
+- Enter the SiliconCloud API Key (register at https://cloud.siliconflow.cn/ to obtain it).
+
+**Important Notes**:
+- The `internlm/internlm2_5-7b-chat` model is freely accessible on SiliconCloud.
+- MindSearch has no financial relationship with SiliconCloud; this service is recommended solely because it provides valuable resources to the open-source community.
+
+### Local Model Deployment
+
+**Features**:
+- Uses the `openmmlab/lmdeploy` image.
+- Based on the PyTorch environment.
+- Requires significant disk space (backend container 15GB+, model 15GB+, totaling 30GB+).
+- Requires a powerful GPU (12GB or more of VRAM recommended).
+
+**Instructions**:
+- Select the "Local Model" option.
+- Choose "internlm_server" as the model format.
+
+**Relevant Links**:
+- lmdeploy image: https://hub.docker.com/r/openmmlab/lmdeploy/tags
+- InternLM2.5 project: https://huggingface.co/internlm/internlm2_5-7b-chat
+
+## Notes
+
+- Currently, only the `internlm_silicon` format works properly for cloud models, and only the `internlm_server` format has passed tests for local models.
+- The language selection only affects the language of the Agent's prompts and does not change the language of the React frontend.
+- The first run might take a long time to download necessary model files and Docker images.
+- When using cloud models, ensure a stable network connection.
+
+## Troubleshooting
+
+1. Ensure the Docker service is running.
+2. Check if there is sufficient disk space.
+3. Ensure all necessary environment variables are set correctly.
+4. Check if the network connection is stable.
+5. Verify the validity of API keys (e.g., for cloud models).
+
+If problems persist, check the Issues section in the MindSearch GitHub repository or submit a new issue.
+
+## Privacy and Security
+
+MSDL is a locally executed tool and does not transmit any API keys or sensitive information. All configuration information is stored in the `msdl/temp/.env` file, used only to simplify the deployment process.
+
+## Updating MSDL
+
+To update MSDL to the latest version, follow these steps:
+
+1. Navigate to the MindSearch directory.
+2. Pull the latest code:
+   ```bash
+   git pull origin main
+   ```
+3. Reinstall MSDL:
+   ```bash
+   cd docker
+   pip install -e .
+   ```
+
+## Conclusion
+
+If you have any questions or suggestions, feel free to submit an issue on GitHub or contact us directly. Thank you for using MindSearch and MSDL!

docker/README_zh-CN.md

@@ -0,0 +1,125 @@
+# MSDL (MindSearch Docker Launcher) 使用指南
+
+[English](README.md) | 简体中文
+
+## 简介
+
+MSDL (MindSearch Docker Launcher) 是一个专为简化 MindSearch 部署过程而设计的命令行工具。它通过交互式界面帮助用户轻松配置和启动 MindSearch 的 Docker 环境，降低了部署的复杂性。MSDL 主要作为部署容器的脚手架，不涉及 MindSearch 核心逻辑的优化。
+
+## 环境要求
+
+- Python 3.7 或更高版本
+- Docker (需包含 Docker Compose，新版本的 Docker 通常已集成)
+- Git (用于克隆仓库)
+- 稳定的网络连接
+- 充足的磁盘空间（根据选择的部署方案，所需空间有所不同）
+
+## 安装步骤
+
+1. 克隆 MindSearch 仓库:
+   ```bash
+   git clone https://github.com/InternLM/MindSearch.git # 已经克隆过的，可以忽略执行此步骤
+   cd MindSearch/docker
+   ```
+
+2. 安装 MSDL:
+   ```bash
+   pip install -e .
+   ```
+
+## 使用方法
+
+安装完成后，您可以在任意目录下运行 MSDL 命令：
+
+```bash
+msdl
+```
+
+按照交互式提示进行配置:
+- 选择 Agent 使用的语言（中文或英文，仅影响 Agent 的提示词语言）
+- 选择模型部署类型（本地模型或云端模型）
+- 选择模型格式
+  - 云端模型目前只有 internlm_silicon 能够正常运行
+  - 本地模型目前只有 internlm_server 通过测试，能正常运行
+- 输入必要的 API 密钥（如 SILICON_API_KEY）
+
+MSDL 将自动执行以下操作:
+- 复制并配置必要的 Dockerfile 和 docker-compose.yaml 文件
+- 构建 Docker 镜像
+- 启动 Docker 容器
+
+## 部署方案比较
+
+### 云端模型部署（推荐）
+
+**优势**:
+- 轻量级部署，磁盘占用小（前端约 510MB，后端约 839MB）
+- 无需高性能硬件
+- 部署和维护简单
+- 使用 SiliconCloud 可免费调用 internlm/internlm2_5-7b-chat 模型
+- 高并发量，推理速度快
+
+**使用说明**:
+- 选择"云端模型"选项
+- 选择 "internlm_silicon" 作为模型格式
+- 输入 SiliconCloud API Key（需在 https://cloud.siliconflow.cn/ 注册获取）
+
+**重要说明**:
+- internlm/internlm2_5-7b-chat 模型在 SiliconCloud 上可以免费调用，但 API Key 仍需妥善保管好。
+- MindSearch 项目与 SiliconCloud 并无利益关系，只是使用它能更好地体验 MindSearch 的效果，感谢 SiliconCloud 为开源社区所做的贡献。
+
+### 本地模型部署
+
+**特点**:
+- 使用 openmmlab/lmdeploy 镜像
+- 基于 PyTorch 环境
+- 需要大量磁盘空间（后端容器 15GB+，模型 15GB+，总计 30GB 以上）
+- 需要强大的 GPU（建议 12GB 或以上显存）
+
+**使用说明**:
+- 选择"本地模型"选项
+- 选择 "internlm_server" 作为模型格式
+
+**相关链接**:
+- lmdeploy 镜像: https://hub.docker.com/r/openmmlab/lmdeploy/tags
+- InternLM2.5 项目: https://huggingface.co/internlm/internlm2_5-7b-chat
+
+## 注意事项
+
+- 云端模型目前只有 internlm_silicon 格式能够正常运行，本地模型只有 internlm_server 格式通过测试能正常运行。
+- 选择语言只会影响 Agent 的提示词语言，不会改变 React 前端的界面语言。
+- 首次运行可能需要较长时间来下载必要的模型文件和 Docker 镜像。
+- 使用云端模型时，请确保网络连接稳定。
+
+## 故障排除
+
+1. 确保 Docker 服务正在运行。
+2. 检查是否有足够的磁盘空间。
+3. 确保所有必要的环境变量已正确设置。
+4. 检查网络连接是否正常。
+5. 验证 API Key 是否有效（如使用云端模型）。
+
+如果问题持续，请查看 MindSearch 的 GitHub 仓库中的 Issues 部分，或提交新的 Issue。
+
+## 隐私和安全
+
+MSDL 是纯本地执行的工具，不会上报任何 API Key 或其他敏感信息。所有配置信息存储在 `msdl/temp/.env` 文件中，仅用于简化部署过程。
+
+## 更新 MSDL
+
+要更新 MSDL 到最新版本，请执行以下步骤:
+
+1. 进入 MindSearch 目录
+2. 拉取最新的代码:
+   ```bash
+   git pull origin main
+   ```
+3. 重新安装 MSDL:
+   ```bash
+   cd docker
+   pip install -e .
+   ```
+
+## 结语
+
+如有任何问题或建议，欢迎在 GitHub 上提交 Issue 或直接联系我们。感谢您使用 MindSearch 和 MSDL！

docker/msdl/__main__.py

@@ -0,0 +1,107 @@
+# msdl/__main__.py
+import signal
+import sys
+import argparse
+import os
+from pathlib import Path
+
+from msdl.config import (
+    BACKEND_DOCKERFILE_DIR,
+    FRONTEND_DOCKERFILE_DIR,
+    PACKAGE_DIR,
+    PROJECT_ROOT,
+    REACT_DOCKERFILE,
+    TEMP_DIR,
+    TEMPLATE_FILES,
+)
+from msdl.docker_manager import (
+    check_docker_install,
+    run_docker_compose,
+    stop_and_remove_containers,
+    update_docker_compose_paths,
+)
+from msdl.i18n import (
+    setup_i18n,
+    t,
+)
+from msdl.utils import (
+    copy_templates_to_temp,
+    copy_backend_dockerfile,
+    copy_frontend_dockerfile,
+    modify_docker_compose,
+)
+from msdl.user_interaction import get_user_choices
+
+
+def signal_handler(signum, frame):
+    print(t("TERMINATION_SIGNAL"))
+    stop_and_remove_containers()
+    sys.exit(0)
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(description=t("CLI_DESCRIPTION"))
+    parser.add_argument('--language', '-l', 
+                      help=t("LANGUAGE_HELP"),
+                      choices=["en", "zh_CN"],
+                      default=None)
+    parser.add_argument('--config-language', action='store_true',
+                      help=t("CONFIG_LANGUAGE_HELP"))
+    return parser.parse_args()
+
+
+def main():
+    # Setup signal handler
+    signal.signal(signal.SIGINT, signal_handler)
+    signal.signal(signal.SIGTERM, signal_handler)
+
+    # Initialize i18n
+    setup_i18n()
+
+    # Parse command line arguments
+    args = parse_args()
+    if args.language:
+        # set_language(args.language)
+        # Reinitialize i18n with new language
+        setup_i18n()
+
+    try:
+        # Check if TEMP_DIR exists, if not, create it
+        if not TEMP_DIR.exists():
+            TEMP_DIR.mkdir(parents=True, exist_ok=True)
+            print(t("TEMP_DIR_CREATED", dir=str(TEMP_DIR)))
+
+        check_docker_install()
+
+        # Get user choices using the new module
+        backend_language, model, model_format, search_engine = get_user_choices()
+
+        # Copy template files
+        copy_templates_to_temp(TEMPLATE_FILES)
+
+        # Copy Dockerfiles
+        copy_backend_dockerfile(model)
+        copy_frontend_dockerfile()
+
+        # Update paths in docker-compose.yml
+        update_docker_compose_paths()
+
+        # Modify docker-compose.yml based on user choices
+        modify_docker_compose(model, backend_language, model_format, search_engine)
+
+        stop_and_remove_containers()
+        run_docker_compose()
+
+        print(t("DOCKER_LAUNCHER_COMPLETE"))
+    except KeyboardInterrupt:
+        print(t("KEYBOARD_INTERRUPT"))
+        # stop_and_remove_containers()
+        sys.exit(0)
+    except Exception as e:
+        print(t("UNEXPECTED_ERROR", error=str(e)))
+        # stop_and_remove_containers()
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

docker/msdl/config.py

@@ -0,0 +1,57 @@
+# msdl/config.py
+
+from pathlib import Path
+
+
+class FileSystemManager:
+
+    @staticmethod
+    def ensure_dir(dir_path):
+        """Ensure the directory exists, create if it doesn't"""
+        path = Path(dir_path)
+        if not path.exists():
+            path.mkdir(parents=True, exist_ok=True)
+        return path
+
+    @staticmethod
+    def ensure_file(file_path, default_content=""):
+        """Ensure the file exists, create if it doesn't"""
+        path = Path(file_path)
+        if not path.parent.exists():
+            FileSystemManager.ensure_dir(path.parent)
+        if not path.exists():
+            with open(path, "w") as f:
+                f.write(default_content)
+        return path
+
+
+# Get the directory where the script is located
+PACKAGE_DIR = Path(__file__).resolve().parent
+
+# Get the root directory of the MindSearch project
+PROJECT_ROOT = PACKAGE_DIR.parent.parent
+
+# Get the temp directory path, which is actually the working directory for executing the docker compose up command
+TEMP_DIR = FileSystemManager.ensure_dir(PACKAGE_DIR / "temp")
+
+# Configuration file name list
+TEMPLATE_FILES = ["docker-compose.yaml"]
+
+# Backend Dockerfile directory
+BACKEND_DOCKERFILE_DIR = "backend"
+
+# Backend Dockerfile name
+CLOUD_LLM_DOCKERFILE = "cloud_llm.dockerfile"
+LOCAL_LLM_DOCKERFILE = "local_llm.dockerfile"
+
+# Frontend Dockerfile directory
+FRONTEND_DOCKERFILE_DIR = "frontend"
+
+# Frontend Dockerfile name
+REACT_DOCKERFILE = "react.dockerfile"
+
+# i18n translations directory
+TRANSLATIONS_DIR = FileSystemManager.ensure_dir(PACKAGE_DIR / "translations")
+
+# Get the path of the .env file
+ENV_FILE_PATH = FileSystemManager.ensure_file(TEMP_DIR / ".env")

docker/msdl/docker_manager.py

@@ -0,0 +1,175 @@
+# msdl/docker_manager.py
+
+import os
+import subprocess
+import sys
+from functools import lru_cache
+
+import yaml
+from msdl.config import PROJECT_ROOT, TEMP_DIR
+from msdl.i18n import t
+
+
+@lru_cache(maxsize=1)
+def get_docker_command():
+    try:
+        subprocess.run(
+            ["docker", "compose", "version"], check=True, capture_output=True
+        )
+        return ["docker", "compose"]
+    except subprocess.CalledProcessError:
+        try:
+            subprocess.run(
+                ["docker-compose", "--version"], check=True, capture_output=True
+            )
+            return ["docker-compose"]
+        except subprocess.CalledProcessError:
+            print(t("DOCKER_COMPOSE_NOT_FOUND"))
+            sys.exit(1)
+
+
+@lru_cache(maxsize=1)
+def check_docker_install():
+    try:
+        subprocess.run(["docker", "--version"], check=True, capture_output=True)
+        docker_compose_cmd = get_docker_command()
+        subprocess.run(
+            docker_compose_cmd + ["version"], check=True, capture_output=True
+        )
+        print(t("DOCKER_INSTALLED"))
+        return True
+    except subprocess.CalledProcessError as e:
+        print(t("DOCKER_INSTALL_ERROR", error=str(e)))
+        return False
+    except FileNotFoundError:
+        print(t("DOCKER_NOT_FOUND"))
+        return False
+
+
+def stop_and_remove_containers():
+    docker_compose_cmd = get_docker_command()
+    compose_file = os.path.join(TEMP_DIR, "docker-compose.yaml")
+
+    # Read the docker-compose.yaml file
+    try:
+        with open(compose_file, "r") as file:
+            compose_config = yaml.safe_load(file)
+    except Exception as e:
+        print(t("COMPOSE_FILE_READ_ERROR", error=str(e)))
+        return
+
+    # Get project name and service names
+    project_name = compose_config.get("name", "mindsearch")
+    service_names = list(compose_config.get("services", {}).keys())
+
+    # Use only the project name as the container prefix
+    container_prefix = f"{project_name}_"
+
+    try:
+        # 1. Try to stop containers using the current docker-compose.yaml
+        subprocess.run(
+            docker_compose_cmd + ["-f", compose_file, "down", "-v", "--remove-orphans"],
+            check=True,
+        )
+    except subprocess.CalledProcessError:
+        print(t("CURRENT_COMPOSE_STOP_FAILED"))
+
+    # 2. Attempt to clean up potentially existing containers, regardless of the success of the previous step
+    try:
+        # List all containers (including stopped ones)
+        result = subprocess.run(
+            ["docker", "ps", "-a", "--format", "{{.Names}}"],
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+        all_containers = result.stdout.splitlines()
+
+        # 3. Filter out containers belonging to our project
+        project_containers = [
+            c
+            for c in all_containers
+            if c.startswith(container_prefix)
+            or any(c == f"{project_name}-{service}" for service in service_names)
+        ]
+
+        if project_containers:
+            # 4. Force stop and remove these containers
+            for container in project_containers:
+                try:
+                    subprocess.run(["docker", "stop", container], check=True)
+                    subprocess.run(["docker", "rm", "-f", container], check=True)
+                    print(t("CONTAINER_STOPPED_AND_REMOVED", container=container))
+                except subprocess.CalledProcessError as e:
+                    print(t("CONTAINER_STOP_ERROR", container=container, error=str(e)))
+
+        # 5. Clean up potentially leftover networks
+        try:
+            subprocess.run(["docker", "network", "prune", "-f"], check=True)
+            print(t("NETWORKS_PRUNED"))
+        except subprocess.CalledProcessError as e:
+            print(t("NETWORK_PRUNE_ERROR", error=str(e)))
+
+    except subprocess.CalledProcessError as e:
+        print(t("DOCKER_LIST_ERROR", error=str(e)))
+
+    print(t("CONTAINERS_STOPPED_AND_REMOVED"))
+
+
+def run_docker_compose():
+    docker_compose_cmd = get_docker_command()
+    try:
+        print(t("STARTING_CONTAINERS_WITH_BUILD"))
+        subprocess.run(
+            docker_compose_cmd
+            + [
+                "-f",
+                os.path.join(TEMP_DIR, "docker-compose.yaml"),
+                "--env-file",
+                os.path.join(TEMP_DIR, ".env"),
+                "up",
+                "-d",
+                "--build",
+            ],
+            check=True,
+        )
+        print(t("CONTAINERS_STARTED"))
+    except subprocess.CalledProcessError as e:
+        print(t("DOCKER_ERROR", error=str(e)))
+        print(t("DOCKER_OUTPUT"))
+        print(e.output.decode() if e.output else "No output")
+        stop_and_remove_containers()
+        sys.exit(1)
+
+
+def update_docker_compose_paths(project_root=PROJECT_ROOT):
+    docker_compose_path = os.path.join(TEMP_DIR, "docker-compose.yaml")
+    with open(docker_compose_path, "r") as file:
+        compose_data = yaml.safe_load(file)
+    for service in compose_data["services"].values():
+        if "build" in service:
+            if "context" in service["build"]:
+                if service["build"]["context"] == "..":
+                    service["build"]["context"] = project_root
+                else:
+                    service["build"]["context"] = os.path.join(
+                        project_root, service["build"]["context"]
+                    )
+            if "dockerfile" in service["build"]:
+                dockerfile_name = os.path.basename(service["build"]["dockerfile"])
+                service["build"]["dockerfile"] = os.path.join(TEMP_DIR, dockerfile_name)
+    with open(docker_compose_path, "w") as file:
+        yaml.dump(compose_data, file)
+    print(t("PATHS_UPDATED"))
+
+
+def main():
+    if check_docker_install():
+        update_docker_compose_paths()
+        run_docker_compose()
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

docker/msdl/i18n.py

@@ -0,0 +1,64 @@
+# msdl/translations/i18n.py
+
+import os
+import i18n
+import locale
+from dotenv import load_dotenv, set_key, find_dotenv
+from msdl.config import TRANSLATIONS_DIR, ENV_FILE_PATH
+from pathlib import Path
+
+# Load environment variables at module level
+load_dotenv(ENV_FILE_PATH)
+
+def get_env_variable(var_name, default=None):
+    return os.getenv(var_name, default)
+
+def set_env_variable(var_name, value):
+    dotenv_file = find_dotenv(ENV_FILE_PATH)
+    set_key(dotenv_file, var_name, value)
+    # Reload environment variables after setting
+    os.environ[var_name] = value
+
+def get_system_language():
+    try:
+        return locale.getlocale()[0].split("_")[0]
+    except:
+        return "en"
+
+def get_available_languages():
+    """Get list of available language codes from translation files"""
+    translations_path = Path(TRANSLATIONS_DIR)
+    if not translations_path.exists():
+        return ["en"]
+    return [f.stem for f in translations_path.glob("*.yaml")]
+
+def set_language(language_code):
+    """Set the interaction language and persist it to .env file"""
+    available_langs = get_available_languages()
+    if language_code not in available_langs:
+        print(f"Warning: Language '{language_code}' not available. Using 'en' instead.")
+        language_code = "en"
+    
+    set_env_variable("LAUNCHER_INTERACTION_LANGUAGE", language_code)
+    i18n.set("locale", language_code)
+
+
+def setup_i18n():
+    # Initialize i18n settings
+    i18n.load_path.append(TRANSLATIONS_DIR)
+    i18n.set("filename_format", "{locale}.{format}")
+    i18n.set("file_format", "yaml")
+
+    # Get language from environment
+    env_language = get_env_variable("LAUNCHER_INTERACTION_LANGUAGE")
+    if not env_language:
+        # If no language is set, use English as default without saving to .env
+        env_language = "en"
+
+    # Force reload translations
+    i18n.set("locale", None)  # Clear current locale
+    i18n.set("locale", env_language)  # Set new locale
+
+
+def t(key, **kwargs):
+    return i18n.t(key, **kwargs)

docker/msdl/templates/backend/cloud_llm.dockerfile

@@ -0,0 +1,25 @@
+# Use Python 3.11.9 as the base image
+FROM python:3.11.9-slim
+
+# Set the working directory
+WORKDIR /root
+
+# Install Git
+RUN apt-get update && apt-get install -y git && apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# Install specified dependency packages
+RUN pip install --no-cache-dir \
+    duckduckgo_search==5.3.1b1 \
+    einops \
+    fastapi \
+    janus \
+    pyvis \
+    sse-starlette \
+    termcolor \
+    uvicorn \
+    griffe==0.48.0 \
+    python-dotenv \ 
+    lagent==0.5.0rc1
+
+# Copy the mindsearch folder to the /root directory of the container
+COPY mindsearch /root/mindsearch

docker/msdl/templates/backend/local_llm.dockerfile

@@ -0,0 +1,30 @@
+# Use openmmlab/lmdeploy:latest-cu12 as the base image
+# Note: Before using this Dockerfile, you should visit https://hub.docker.com/r/openmmlab/lmdeploy/tags
+# to select a base image that's compatible with your specific GPU architecture.
+# The 'latest-cu12' tag is used here as an example, but you should choose the most 
+# appropriate tag for your setup (e.g., cu11 for CUDA 11, cu12 for CUDA 12, etc.)
+FROM openmmlab/lmdeploy:latest-cu12
+
+# Set the working directory
+WORKDIR /root
+
+# Install Git
+RUN apt-get update && apt-get install -y git && apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# Install specified dependency packages
+# Note: lmdeploy dependency is already included in the base image, no need to reinstall
+RUN pip install --no-cache-dir \
+    duckduckgo_search==5.3.1b1 \
+    einops \
+    fastapi \
+    janus \
+    pyvis \
+    sse-starlette \
+    termcolor \
+    uvicorn \
+    griffe==0.48.0 \
+    python-dotenv \ 
+    lagent==0.5.0rc1
+
+# Copy the mindsearch folder to the /root directory of the container
+COPY mindsearch /root/mindsearch

docker/msdl/templates/docker-compose.yaml

@@ -0,0 +1,62 @@
+services:
+  backend:
+    container_name: mindsearch-backend
+    build:
+      context: .
+      dockerfile: backend.dockerfile
+    image: mindsearch/backend:latest
+    restart: unless-stopped
+    # Uncomment the following line to force using local build
+    # pull: never
+    ports:
+      - "8002:8002"
+    environment:
+      - PYTHONUNBUFFERED=1
+      # - OPENAI_API_KEY=${OPENAI_API_KEY:-}
+      - OPENAI_API_BASE=${OPENAI_API_BASE:-https://api.openai.com/v1}
+      # - QWEN_API_KEY=${QWEN_API_KEY:-}
+      # - SILICON_API_KEY=${SILICON_API_KEY:-}
+    command: python -m mindsearch.app --lang ${LANG:-cn} --model_format ${MODEL_FORMAT:-internlm_server}
+    volumes:
+      - /root/.cache:/root/.cache
+    deploy:
+      resources:
+        reservations:
+          devices:
+            - driver: nvidia
+              count: 1
+              capabilities: [gpu]
+    # GPU support explanation:
+    # The current configuration has been tested with NVIDIA GPUs. If you use other types of GPUs, you may need to adjust the configuration.
+    # For AMD GPUs, you can try using the ROCm driver by modifying the configuration as follows:
+    # deploy:
+    #   resources:
+    #     reservations:
+    #       devices:
+    #         - driver: amd
+    #           count: 1
+    #           capabilities: [gpu]
+    #
+    # For other GPU types, you may need to consult the respective Docker GPU support documentation.
+    # In theory, any GPU supported by PyTorch should be configurable here.
+    # If you encounter issues, try the following steps:
+    # 1. Ensure the correct GPU drivers are installed on the host
+    # 2. Check if your Docker version supports your GPU type
+    # 3. Install necessary GPU-related libraries in the Dockerfile
+    # 4. Adjust the deploy configuration here to match your GPU type
+    #
+    # Note: After changing GPU configuration, you may need to rebuild the image.
+
+  frontend:
+    container_name: mindsearch-frontend
+    build:
+      context: .
+      dockerfile: frontend.dockerfile
+    image: mindsearch/frontend:latest
+    restart: unless-stopped
+    # Uncomment the following line to force using local build
+    # pull: never
+    ports:
+      - "8080:8080"
+    depends_on:
+      - backend

docker/msdl/templates/frontend/react.dockerfile

@@ -0,0 +1,35 @@
+# Use Node.js 18 as the base image
+FROM node:18-alpine
+
+# Set the working directory
+WORKDIR /app
+
+# Copy package files first to leverage Docker cache
+COPY frontend/React/package*.json ./
+
+# Install dependencies
+RUN npm install
+
+# Copy source code after npm install to prevent unnecessary reinstalls
+COPY frontend/React/ ./
+
+# Modify vite.config.ts for Docker environment
+# Beacuse we use Docker Compose to manage the backend and frontend services, we can use the service name as the hostname
+RUN sed -i '/server: {/,/},/c\
+    server: {\
+    host: "0.0.0.0",\
+    port: 8080,\
+    proxy: {\
+    "/solve": {\
+    target: "http://backend:8002",\
+    changeOrigin: true,\
+    },\
+    // "/solve": {\
+    //   target: "https://mindsearch.openxlab.org.cn",\
+    //   changeOrigin: true,\
+    // },\
+    },\
+    },' vite.config.ts
+
+# Start the development server
+CMD ["npm", "start"]

docker/msdl/translations/en.yaml

@@ -0,0 +1,77 @@
+en:
+  SCRIPT_DIR: "Script directory: %{dir}"
+  PROJECT_ROOT: "Project root directory: %{dir}"
+  TEMP_DIR: "Temporary directory: %{dir}"
+  DOCKER_LAUNCHER_START: "Starting Docker launcher process"
+  DOCKER_LAUNCHER_COMPLETE: "Docker launcher process completed"
+  DIR_CREATED: "Directory created: %{dir}"
+  FILE_COPIED: "Copied %{file} to the temp directory"
+  FILE_NOT_FOUND: "Error: %{file} not found in the templates directory"
+  CONTAINERS_STOPPED: "Existing containers and volumes stopped and removed"
+  CONTAINER_STOP_ERROR: "Error stopping and removing containers (this may be normal if there were no running containers): %{error}"
+  BUILDING_IMAGES: "Starting to build Docker images..."
+  IMAGES_BUILT: "Docker images built successfully"
+  STARTING_CONTAINERS: "Starting Docker containers..."
+  STARTING_CONTAINERS_WITH_BUILD: "Starting to build and start Docker containers..."
+  CONTAINERS_STARTED: "Docker containers started successfully"
+  DOCKER_ERROR: "Error while building or starting Docker containers: %{error}"
+  DOCKER_OUTPUT: "Docker command output:"
+  DOCKER_INSTALLED: "Docker and Docker Compose installed correctly"
+  DOCKER_INSTALL_ERROR: "Error: Docker or Docker Compose may not be installed correctly: %{error}"
+  DOCKER_NOT_FOUND: "Error: Docker or Docker Compose command not found. Please ensure they are correctly installed and added to the PATH."
+  DOCKER_COMPOSE_NOT_FOUND: "Error: Docker Compose command not found. Please ensure it is correctly installed and added to the PATH."
+  PATHS_UPDATED: "Paths updated in docker-compose.yaml"
+  COMPOSE_FILE_CONTENT: "docker-compose.yaml file content:"
+  COMPOSE_FILE_NOT_FOUND: "Error: %{file} file not found"
+  COMPOSE_FILE_READ_ERROR: "Error reading docker-compose.yaml file: %{error}"
+  TERMINATION_SIGNAL: "Termination signal caught. Exiting gracefully..."
+  KEYBOARD_INTERRUPT: "Keyboard interrupt caught. Exiting gracefully..."
+  UNEXPECTED_ERROR: "An unexpected error occurred: %{error}"
+  BACKEND_LANGUAGE_CHOICE: "Select MindSearch backend language (default is cn)"
+  CHINESE: "Chinese (cn)"
+  ENGLISH: "English (en)"
+  MODEL_DEPLOYMENT_TYPE: "Select model deployment type:"
+  CLOUD_MODEL: "Cloud model"
+  LOCAL_MODEL: "Local model"
+  MODEL_FORMAT_CHOICE: "Select model format:"
+  CONFIRM_USE_EXISTING_API_KEY: "Do you want to use the existing %{ENV_VAR_NAME} API key?"
+  CONFIRM_OVERWRITE_EXISTING_API_KEY: "Do you want to overwrite the existing %{ENV_VAR_NAME} API key?"
+  PLEASE_INPUT_NEW_API_KEY: "Please enter a new %{ENV_VAR_NAME} API key:"
+  PLEASE_INPUT_NEW_API_KEY_FROM_ZERO: "Please enter a new %{ENV_VAR_NAME} API key:"
+  INVALID_API_KEY_FORMAT: "Invalid API key format"
+  RETRY_API_KEY_INPUT: "Retry API key input"
+  API_KEY_INPUT_CANCELLED: "API key input cancelled"
+  UNKNOWN_API_KEY_TYPE: "Unknown API key type: %{KEY_TYPE}"
+  UNKNOWN_MODEL_FORMAT: "Unknown model format: %{MODEL_FORMAT}"
+  INVALID_API_KEY: "Invalid API key: %{KEY_TYPE}"
+  API_KEY_SAVED: "API key for %{ENV_VAR_NAME} saved"
+  UNKNOWN_DOCKERFILE: "Unknown Dockerfile: %{dockerfile}"
+  UNKNOWN_MODEL_TYPE: "Unknown model type: %{model_type}"
+  BACKEND_DOCKERFILE_COPIED: "Backend Dockerfile copied from %{source_path} to %{dest_path}"
+  FRONTEND_DOCKERFILE_COPIED: "Frontend Dockerfile copied from %{source_path} to %{dest_path}"
+  TEMP_DIR_CREATED: "Temporary directory created at %{dir}"
+  CURRENT_COMPOSE_STOP_FAILED: "Current containers stop failed"
+  CONTAINER_STOPPED_AND_REMOVED: "Container stopped and removed"
+  NETWORKS_PRUNED: "Corresponding Docker networks pruned"
+  NETWORK_PRUNE_ERROR: "Error pruning corresponding Docker networks: %{error}"
+  DOCKER_LIST_ERROR: "Error listing Docker containers: %{error}"
+  CONTAINERS_STOPPED_AND_REMOVED: "Docker containers stopped and removed"
+  CLI_DESCRIPTION: "MindSearch Docker Launcher - A tool to manage MindSearch docker containers"
+  LANGUAGE_HELP: "Set the msdl tool interface language (e.g. en, zh_CN)"
+  CONFIG_LANGUAGE_HELP: "Show language configuration prompt"
+  LANGUAGE_NOT_AVAILABLE: "Warning: Language '%{lang}' not available. Using English instead."
+  SELECT_INTERFACE_LANGUAGE: "Select msdl tool interface language"
+  SELECT_BACKEND_LANGUAGE: "Select MindSearch backend language (default is cn)"
+  LANGUAGE_CHANGED_RESTARTING: "Language changed, restarting msdl..."
+  SELECT_SEARCH_ENGINE: "Select search engine:"
+  NO_API_KEY_NEEDED: "No API key needed"
+  API_KEY_REQUIRED: "API key required"
+  SEARCH_ENGINE_GOOGLE: "Google Search"
+  SEARCH_ENGINE_BING: "Bing Search"
+  SEARCH_ENGINE_DUCKDUCKGO: "DuckDuckGo Search"
+  SEARCH_ENGINE_BRAVE: "Brave Search"
+  SEARCH_ENGINE_TENCENT: "Tencent Search"
+  TENCENT_ID_REQUIRED: "Please enter your Tencent Search Secret ID"
+  TENCENT_KEY_REQUIRED: "Please enter your Tencent Search Secret Key"
+  WEB_SEARCH_KEY_REQUIRED: "Please enter your Web Search API Key"
+  SEARCH_ENGINE_CONFIGURED: "Search engine %{engine} configured successfully"

docker/msdl/translations/zh_CN.yaml

@@ -0,0 +1,77 @@
+zh_CN:
+  SCRIPT_DIR: "脚本目录：%{dir}"
+  PROJECT_ROOT: "项目根目录：%{dir}"
+  TEMP_DIR: "临时目录：%{dir}"
+  DOCKER_LAUNCHER_START: "开始 Docker 启动器流程"
+  DOCKER_LAUNCHER_COMPLETE: "Docker 启动器流程完成"
+  DIR_CREATED: "创建目录：%{dir}"
+  FILE_COPIED: "已复制 %{file} 到 temp 目录"
+  FILE_NOT_FOUND: "错误：%{file} 在 templates 目录中不存在"
+  CONTAINERS_STOPPED: "已停止并删除现有容器和卷"
+  CONTAINER_STOP_ERROR: "停止和删除容器时出错（这可能是正常的，如果没有正在运行的容器）：%{error}"
+  BUILDING_IMAGES: "开始构建Docker镜像..."
+  IMAGES_BUILT: "Docker镜像构建成功"
+  STARTING_CONTAINERS: "开始启动Docker容器..."
+  STARTING_CONTAINERS_WITH_BUILD: "开始构建并启动Docker容器..."
+  CONTAINERS_STARTED: "Docker 容器已成功启动"
+  DOCKER_ERROR: "构建或启动 Docker 容器时出错：%{error}"
+  DOCKER_OUTPUT: "Docker 命令输出："
+  DOCKER_INSTALLED: "Docker 和 Docker Compose 安装正确"
+  DOCKER_INSTALL_ERROR: "错误：Docker 或 Docker Compose 可能没有正确安装：%{error}"
+  DOCKER_NOT_FOUND: "错误：Docker 或 Docker Compose 命令未找到。请确保它们已正确安装并添加到PATH中。"
+  DOCKER_COMPOSE_NOT_FOUND: "错误：Docker Compose 命令未找到。请确保它已正确安装并添加到PATH中。"
+  PATHS_UPDATED: "已更新 docker-compose.yaml 中的路径"
+  COMPOSE_FILE_CONTENT: "docker-compose.yaml 文件内容："
+  COMPOSE_FILE_NOT_FOUND: "错误：%{file} 文件不存在"
+  COMPOSE_FILE_READ_ERROR: "读取 docker-compose.yaml 文件时出错：%{error}"
+  TERMINATION_SIGNAL: "捕获到终止信号。正在优雅地退出..."
+  KEYBOARD_INTERRUPT: "捕获到键盘中断。正在优雅地退出..."
+  UNEXPECTED_ERROR: "发生未预期的错误：%{error}"
+  BACKEND_LANGUAGE_CHOICE: "选择 MindSearch 后端语言（默认为中文）"
+  SELECT_INTERFACE_LANGUAGE: "选择 msdl 工具界面语言"
+  SELECT_BACKEND_LANGUAGE: "选择 MindSearch 后端语言（默认为中文）"
+  CHINESE: "中文 (cn)"
+  ENGLISH: "英文 (en)"
+  MODEL_DEPLOYMENT_TYPE: "选择模型部署类型："
+  CLOUD_MODEL: "云端模型"
+  LOCAL_MODEL: "本地模型"
+  MODEL_FORMAT_CHOICE: "选择模型格式："
+  CONFIRM_USE_EXISTING_API_KEY: "是否使用现有的 %{ENV_VAR_NAME} API 密钥？"
+  CONFIRM_OVERWRITE_EXISTING_API_KEY: "是否覆盖现有的 %{ENV_VAR_NAME} API 密钥？"
+  PLEASE_INPUT_NEW_API_KEY: "请输入新的 %{ENV_VAR_NAME} API 密钥："
+  PLEASE_INPUT_NEW_API_KEY_FROM_ZERO: "请输入新的 %{ENV_VAR_NAME} API 密钥："
+  INVALID_API_KEY_FORMAT: "无效的 API 密钥格式"
+  RETRY_API_KEY_INPUT: "重试 API 密钥输入"
+  API_KEY_INPUT_CANCELLED: "API 密钥输入已取消"
+  UNKNOWN_API_KEY_TYPE: "未知的 API 密钥类型：%{KEY_TYPE}"
+  UNKNOWN_MODEL_FORMAT: "未知的模型格式：%{MODEL_FORMAT}"
+  INVALID_API_KEY: "无效的 API 密钥：%{KEY_TYPE}"
+  API_KEY_SAVED: "%{ENV_VAR_NAME} 的 API 密钥已保存"
+  UNKNOWN_DOCKERFILE: "未知的 Dockerfile：%{dockerfile}"
+  UNKNOWN_MODEL_TYPE: "未知的模型类型：%{model_type}"
+  BACKEND_DOCKERFILE_COPIED: "后端 Dockerfile 已经从 %{source_path} 复制为 %{dest_path}"
+  FRONTEND_DOCKERFILE_COPIED: "前端 Dockerfile 已经从 %{source_path} 复制为 %{dest_path}"
+  TEMP_DIR_CREATED: "已在 %{dir} 创建临时目录"
+  CURRENT_COMPOSE_STOP_FAILED: "当前的容器停止失败"
+  CONTAINER_STOPPED_AND_REMOVED: "容器已停止并删除"
+  NETWORKS_PRUNED: "已清理对应的Docker网络"
+  NETWORK_PRUNE_ERROR: "清理对应的Docker网络时出错：%{error}"
+  DOCKER_LIST_ERROR: "列出 Docker 容器时出错：%{error}"
+  CONTAINERS_STOPPED_AND_REMOVED: "已停止并删除 Docker 容器"
+  CLI_DESCRIPTION: "MindSearch Docker 启动器 - 用于管理 MindSearch docker 容器的工具"
+  LANGUAGE_HELP: "设置 msdl 工具界面语言（例如：en, zh_CN）"
+  CONFIG_LANGUAGE_HELP: "显示语言配置提示"
+  LANGUAGE_NOT_AVAILABLE: "警告：语言'%{lang}'不可用。使用英语作为替代。"
+  LANGUAGE_CHANGED_RESTARTING: "语言已更改，正在重启 msdl..."
+  SELECT_SEARCH_ENGINE: "选择搜索引擎："
+  NO_API_KEY_NEEDED: "无需 API 密钥"
+  API_KEY_REQUIRED: "需要 API 密钥"
+  SEARCH_ENGINE_DUCKDUCKGO: "DuckDuckGo 搜索"
+  SEARCH_ENGINE_BING: "必应搜索"
+  SEARCH_ENGINE_BRAVE: "Brave 搜索"
+  SEARCH_ENGINE_GOOGLE: "Google 搜索"
+  SEARCH_ENGINE_TENCENT: "腾讯搜索"
+  TENCENT_ID_REQUIRED: "请输入您的腾讯搜索 Secret ID"
+  TENCENT_KEY_REQUIRED: "请输入您的腾讯搜索 Secret Key"
+  WEB_SEARCH_KEY_REQUIRED: "请输入您的网页搜索 API 密钥"
+  SEARCH_ENGINE_CONFIGURED: "搜索引擎 %{engine} 配置成功"

docker/msdl/user_interaction.py

@@ -0,0 +1,253 @@
+from InquirerPy import inquirer
+import sys
+import os
+from pathlib import Path
+
+from msdl.config import (
+    CLOUD_LLM_DOCKERFILE,
+    LOCAL_LLM_DOCKERFILE,
+)
+from msdl.i18n import (
+    t,
+    get_available_languages,
+    set_language,
+    get_env_variable,
+)
+from msdl.utils import (
+    clean_api_key,
+    get_model_formats,
+    get_existing_api_key,
+    save_api_key_to_env,
+    validate_api_key,
+)
+
+SEARCH_ENGINES = {
+    "DuckDuckGoSearch": {
+        "name": "DuckDuckGo",
+        "key": "DUCKDUCKGO",
+        "requires_key": False,
+        "env_var": None
+    },
+    "BingSearch": {
+        "name": "Bing",
+        "key": "BING",
+        "requires_key": True,
+        "env_var": "BING_SEARCH_API_KEY"
+    },
+    "BraveSearch": {
+        "name": "Brave",
+        "key": "BRAVE",
+        "requires_key": True,
+        "env_var": "BRAVE_SEARCH_API_KEY"
+    },
+    "GoogleSearch": {
+        "name": "Google Serper",
+        "key": "GOOGLE",
+        "requires_key": True,
+        "env_var": "GOOGLE_SERPER_API_KEY"
+    },
+    "TencentSearch": {
+        "name": "Tencent",
+        "key": "TENCENT",
+        "requires_key": True,
+        "env_vars": ["TENCENT_SEARCH_SECRET_ID", "TENCENT_SEARCH_SECRET_KEY"]
+    }
+}
+
+def get_language_choice():
+    """Get user's language preference"""
+    def _get_language_options():
+        available_langs = get_available_languages()
+        lang_choices = {
+            "en": "English",
+            "zh_CN": "中文"
+        }
+        return [{"name": f"{lang_choices.get(lang, lang)}", "value": lang} for lang in available_langs]
+
+    current_lang = get_env_variable("LAUNCHER_INTERACTION_LANGUAGE")
+    if not current_lang:
+        lang_options = _get_language_options()
+        language = inquirer.select(
+            message=t("SELECT_INTERFACE_LANGUAGE"),
+            choices=lang_options,
+            default="en"
+        ).execute()
+        
+        if language:
+            set_language(language)
+            sys.stdout.flush()
+            restart_program()
+
+def get_backend_language():
+    """Get user's backend language preference"""
+    return inquirer.select(
+        message=t("SELECT_BACKEND_LANGUAGE"),
+        choices=[
+            {"name": t("CHINESE"), "value": "cn"},
+            {"name": t("ENGLISH"), "value": "en"},
+        ],
+        default="cn",
+    ).execute()
+
+def get_model_choice():
+    """Get user's model deployment type preference"""
+    model_deployment_type = [
+        {
+            "name": t("CLOUD_MODEL"),
+            "value": CLOUD_LLM_DOCKERFILE
+        },
+        {
+            "name": t("LOCAL_MODEL"),
+            "value": LOCAL_LLM_DOCKERFILE
+        },
+    ]
+
+    return inquirer.select(
+        message=t("MODEL_DEPLOYMENT_TYPE"),
+        choices=model_deployment_type,
+    ).execute()
+
+def get_model_format(model):
+    """Get user's model format preference"""
+    model_formats = get_model_formats(model)
+    return inquirer.select(
+        message=t("MODEL_FORMAT_CHOICE"),
+        choices=[{
+            "name": format,
+            "value": format
+        } for format in model_formats],
+    ).execute()
+
+def _handle_api_key_input(env_var_name, message=None):
+    """Handle API key input and validation for a given environment variable"""
+    if message is None:
+        message = t("PLEASE_INPUT_NEW_API_KEY", ENV_VAR_NAME=env_var_name)
+    print(message)
+    
+    while True:
+        api_key = inquirer.secret(
+            message=t("PLEASE_INPUT_NEW_API_KEY_FROM_ZERO", ENV_VAR_NAME=env_var_name)
+        ).execute()
+        cleaned_api_key = clean_api_key(api_key)
+
+        try:
+            save_api_key_to_env(env_var_name, cleaned_api_key, t)
+            break
+        except ValueError as e:
+            print(str(e))
+            retry = inquirer.confirm(
+                message=t("RETRY_API_KEY_INPUT"), default=True
+            ).execute()
+            if not retry:
+                print(t("API_KEY_INPUT_CANCELLED"))
+                sys.exit(1)
+
+def handle_api_key_input(model, model_format):
+    """Handle API key input and validation"""
+    if model != CLOUD_LLM_DOCKERFILE:
+        return
+
+    env_var_name = {
+        "internlm_silicon": "SILICON_API_KEY",
+        "gpt4": "OPENAI_API_KEY",
+        "qwen": "QWEN_API_KEY",
+    }.get(model_format)
+
+    existing_api_key = get_existing_api_key(env_var_name)
+
+    if existing_api_key:
+        use_existing = inquirer.confirm(
+            message=t("CONFIRM_USE_EXISTING_API_KEY", ENV_VAR_NAME=env_var_name),
+            default=True,
+        ).execute()
+
+        if use_existing:
+            return
+
+        print(t("CONFIRM_OVERWRITE_EXISTING_API_KEY", ENV_VAR_NAME=env_var_name))
+
+    try:
+        save_api_key_to_env(model_format, clean_api_key(inquirer.secret(
+            message=t("PLEASE_INPUT_NEW_API_KEY_FROM_ZERO", ENV_VAR_NAME=env_var_name)
+        ).execute()), t)
+    except ValueError as e:
+        print(str(e))
+        retry = inquirer.confirm(
+            message=t("RETRY_API_KEY_INPUT"), default=True
+        ).execute()
+        if not retry:
+            print(t("API_KEY_INPUT_CANCELLED"))
+            sys.exit(1)
+
+def get_search_engine():
+    """Get user's preferred search engine and handle API key if needed"""
+    search_engine = inquirer.select(
+        message=t("SELECT_SEARCH_ENGINE"),
+        choices=[{
+            "name": f"{t(f'SEARCH_ENGINE_{info["key"]}')} ({t('NO_API_KEY_NEEDED') if not info['requires_key'] else t('API_KEY_REQUIRED')})",
+            "value": engine
+        } for engine, info in SEARCH_ENGINES.items()],
+    ).execute()
+
+    engine_info = SEARCH_ENGINES[search_engine]
+    
+    if engine_info['requires_key']:
+        if search_engine == "TencentSearch":
+            # Handle Tencent's special case with two keys
+            for env_var in engine_info['env_vars']:
+                is_id = "ID" in env_var
+                message = t("TENCENT_ID_REQUIRED") if is_id else t("TENCENT_KEY_REQUIRED")
+                existing_key = get_existing_api_key(env_var)
+                if existing_key:
+                    use_existing = inquirer.confirm(
+                        message=t("CONFIRM_USE_EXISTING_API_KEY", ENV_VAR_NAME=env_var),
+                        default=True,
+                    ).execute()
+                    if not use_existing:
+                        _handle_api_key_input(env_var, message)
+                else:
+                    _handle_api_key_input(env_var, message)
+        else:
+            # Handle standard case with single WEB_SEARCH_API_KEY
+            env_var = engine_info['env_var']
+            existing_key = get_existing_api_key(env_var)
+            if existing_key:
+                use_existing = inquirer.confirm(
+                    message=t("CONFIRM_USE_EXISTING_API_KEY", ENV_VAR_NAME=env_var),
+                    default=True,
+                ).execute()
+                if not use_existing:
+                    _handle_api_key_input(env_var, t("WEB_SEARCH_KEY_REQUIRED"))
+            else:
+                _handle_api_key_input(env_var, t("WEB_SEARCH_KEY_REQUIRED"))
+    
+    print(t("SEARCH_ENGINE_CONFIGURED", engine=engine_info['name']))
+    return search_engine
+
+def restart_program():
+    """Restart the current program with the same arguments"""
+    print(t("LANGUAGE_CHANGED_RESTARTING"))
+    python = sys.executable
+    os.execl(python, python, *sys.argv)
+
+def get_user_choices():
+    """Get all user choices in a single function"""
+    # Get language preference
+    get_language_choice()
+    
+    # Get backend language
+    backend_language = get_backend_language()
+    
+    # Get model choice
+    model = get_model_choice()
+    
+    # Get model format
+    model_format = get_model_format(model)
+    
+    # Get search engine choice
+    search_engine = get_search_engine()
+    
+    # Handle API key if needed
+    handle_api_key_input(model, model_format)
+    
+    return backend_language, model, model_format, search_engine

docker/msdl/utils.py

@@ -0,0 +1,257 @@
+# msdl/utils.py
+
+import os
+import re
+import shutil
+import sys
+import yaml
+from functools import lru_cache
+from pathlib import Path
+from msdl.config import (
+    BACKEND_DOCKERFILE_DIR,
+    CLOUD_LLM_DOCKERFILE,
+    FRONTEND_DOCKERFILE_DIR,
+    LOCAL_LLM_DOCKERFILE,
+    PACKAGE_DIR,
+    REACT_DOCKERFILE,
+    TEMP_DIR,
+    ENV_FILE_PATH,
+)
+from msdl.i18n import t
+
+
+@lru_cache(maxsize=None)
+def get_env_variable(var_name, default=None):
+    if ENV_FILE_PATH.exists():
+        with ENV_FILE_PATH.open("r") as env_file:
+            for line in env_file:
+                if line.startswith(f"{var_name}="):
+                    return line.strip().split("=", 1)[1]
+    return os.getenv(var_name, default)
+
+
+@lru_cache(maxsize=None)
+def get_existing_api_key(env_var_name):
+    env_vars = read_env_file()
+    return env_vars.get(env_var_name)
+
+
+@lru_cache(maxsize=None)
+def read_env_file():
+    env_vars = {}
+    if ENV_FILE_PATH.exists():
+        with ENV_FILE_PATH.open("r") as env_file:
+            for line in env_file:
+                if "=" in line and not line.strip().startswith("#"):
+                    key, value = line.strip().split("=", 1)
+                    env_vars[key] = value.strip('"').strip("'")
+    return env_vars
+
+
+def clean_api_key(api_key):
+    cleaned_key = api_key.strip()
+    cleaned_key = re.sub(r"\s+", "", cleaned_key)
+    return cleaned_key
+
+
+@lru_cache(maxsize=None)
+def validate_api_key(api_key, key_type, t):
+    basic_pattern = r"^sk-[A-Za-z0-9]+$"
+    web_search_pattern = r"^[A-Za-z0-9_\-\.]+$"
+    tencent_pattern = r"^[A-Za-z0-9]+$"
+
+    validation_rules = {
+        # Model API Keys
+        "SILICON_API_KEY": basic_pattern,
+        "OPENAI_API_KEY": basic_pattern,
+        "QWEN_API_KEY": basic_pattern,
+        # Search Engine API Keys
+        "BING_SEARCH_API_KEY": web_search_pattern,
+        "BRAVE_SEARCH_API_KEY": web_search_pattern,
+        "GOOGLE_SERPER_API_KEY": web_search_pattern,
+        "TENCENT_SEARCH_SECRET_ID": tencent_pattern,
+        "TENCENT_SEARCH_SECRET_KEY": tencent_pattern,
+        # Legacy support
+        "WEB_SEARCH_API_KEY": web_search_pattern,
+    }
+
+    if key_type not in validation_rules:
+        raise ValueError(t("UNKNOWN_API_KEY_TYPE", KEY_TYPE=key_type))
+
+    pattern = validation_rules[key_type]
+    return re.match(pattern, api_key) is not None
+
+
+def save_api_key_to_env(key_type, api_key, t):
+    """Save API key to .env file
+    
+    Args:
+        key_type: Environment variable name or model format
+        api_key: API key value
+        t: Translation function
+    """
+    # Convert model format to env var name if needed
+    env_var_name = {
+        "internlm_silicon": "SILICON_API_KEY",
+        "gpt4": "OPENAI_API_KEY",
+        "qwen": "QWEN_API_KEY",
+    }.get(key_type, key_type)  # If not a model format, use key_type directly
+
+    if not validate_api_key(api_key, env_var_name, t):
+        raise ValueError(t("INVALID_API_KEY", KEY_TYPE=env_var_name))
+
+    env_vars = read_env_file()
+    env_vars[env_var_name] = api_key
+
+    with ENV_FILE_PATH.open("w") as env_file:
+        for key, value in env_vars.items():
+            env_file.write(f"{key}={value}\n")
+
+    print(t("API_KEY_SAVED", ENV_VAR_NAME=env_var_name))
+
+
+def ensure_directory(path):
+    path = Path(path)
+    if not path.exists():
+        path.mkdir(parents=True, exist_ok=True)
+        print(t("DIR_CREATED", dir=path))
+
+
+def copy_templates_to_temp(template_files):
+    template_dir = PACKAGE_DIR / "templates"
+
+    ensure_directory(TEMP_DIR)
+
+    for filename in template_files:
+        src = template_dir / filename
+        dst = TEMP_DIR / filename
+        if src.exists():
+            shutil.copy2(src, dst)
+            print(t("FILE_COPIED", file=filename))
+        else:
+            print(t("FILE_NOT_FOUND", file=filename))
+            sys.exit(1)
+
+
+def modify_docker_compose(model_type, backend_language, model_format, search_engine):
+    """Modify docker-compose.yaml based on user choices"""
+    docker_compose_path = os.path.join(TEMP_DIR, "docker-compose.yaml")
+    with open(docker_compose_path, "r") as file:
+        compose_data = yaml.safe_load(file)
+
+    # Set the name of the project
+    compose_data["name"] = "mindsearch"
+
+    # Configure backend service
+    backend_service = compose_data["services"]["backend"]
+    
+    # Set environment variables
+    if "environment" not in backend_service:
+        backend_service["environment"] = []
+
+    # Add or update environment variables
+    env_vars = {
+        "LANG": backend_language,
+        "MODEL_FORMAT": model_format,
+        "SEARCH_ENGINE": search_engine
+    }
+
+    # Ensure .env file is included
+    if "env_file" not in backend_service:
+        backend_service["env_file"] = [".env"]
+    elif ".env" not in backend_service["env_file"]:
+        backend_service["env_file"].append(".env")
+
+    # Set command with all parameters
+    command = f"python -m mindsearch.app --lang {backend_language} --model_format {model_format} --search_engine {search_engine}"
+    backend_service["command"] = command
+
+    # Convert environment variables to docker-compose format
+    backend_service["environment"] = [
+        f"{key}={value}" for key, value in env_vars.items()
+    ]
+
+    # Configure based on model type
+    if model_type == CLOUD_LLM_DOCKERFILE:
+        if "deploy" in backend_service:
+            del backend_service["deploy"]
+        # Remove volumes for cloud deployment
+        if "volumes" in backend_service:
+            del backend_service["volumes"]
+    elif model_type == LOCAL_LLM_DOCKERFILE:
+        # Add GPU configuration for local deployment
+        if "deploy" not in backend_service:
+            backend_service["deploy"] = {
+                "resources": {
+                    "reservations": {
+                        "devices": [
+                            {"driver": "nvidia", "count": 1, "capabilities": ["gpu"]}
+                        ]
+                    }
+                }
+            }
+        # Add volume for cache in local deployment
+        backend_service["volumes"] = ["/root/.cache:/root/.cache"]
+    else:
+        raise ValueError(t("UNKNOWN_DOCKERFILE", dockerfile=model_type))
+
+    # Save the modified docker-compose.yaml
+    with open(docker_compose_path, "w") as file:
+        yaml.dump(compose_data, file)
+
+    print(
+        t(
+            "docker_compose_updated",
+            mode=(t("CLOUD") if model_type == CLOUD_LLM_DOCKERFILE else t("LOCAL")),
+            format=model_format,
+        )
+    )
+
+
+def get_model_formats(model_type):
+    if model_type == CLOUD_LLM_DOCKERFILE:
+        return ["internlm_silicon", "qwen", "gpt4"]
+    elif model_type == LOCAL_LLM_DOCKERFILE:
+        return ["internlm_server", "internlm_client", "internlm_hf"]
+    else:
+        raise ValueError(t("UNKNOWN_MODEL_TYPE", model_type=model_type))
+
+
+def copy_backend_dockerfile(choice):
+    """Copy backend Dockerfile to temp directory based on user choice"""
+    source_file = Path(BACKEND_DOCKERFILE_DIR) / choice
+    dest_file = "backend.dockerfile"
+    source_path = PACKAGE_DIR / "templates" / source_file
+    dest_path = TEMP_DIR / dest_file
+
+    if not source_path.exists():
+        raise FileNotFoundError(t("FILE_NOT_FOUND", file=source_file))
+
+    dest_path.parent.mkdir(parents=True, exist_ok=True)
+    dest_path.write_text(source_path.read_text())
+    print(
+        t(
+            "BACKEND_DOCKERFILE_COPIED",
+            source_path=str(source_path),
+            dest_path=str(dest_path),
+        ))
+
+
+def copy_frontend_dockerfile():
+    """Copy frontend Dockerfile to temp directory"""
+    source_file = Path(FRONTEND_DOCKERFILE_DIR) / REACT_DOCKERFILE
+    dest_file = "frontend.dockerfile"
+    source_path = PACKAGE_DIR / "templates" / source_file
+    dest_path = TEMP_DIR / dest_file
+
+    if not source_path.exists():
+        raise FileNotFoundError(t("FILE_NOT_FOUND", file=source_file))
+
+    dest_path.parent.mkdir(parents=True, exist_ok=True)
+    dest_path.write_text(source_path.read_text())
+    print(
+        t(
+            "FRONTEND_DOCKERFILE_COPIED",
+            source_path=str(source_path),
+            dest_path=str(dest_path),
+        ))

docker/setup.py

@@ -0,0 +1,24 @@
+from setuptools import find_packages, setup
+
+setup(
+    name="msdl",
+    version="0.1.1",
+    description="MindSearch Docker Launcher",
+    packages=find_packages(),
+    python_requires=">=3.7",
+    install_requires=[
+        "pyyaml>=6.0",
+        "python-i18n>=0.3.9",
+        "inquirerpy>=0.3.4",
+        "python-dotenv>=0.19.1",
+    ],
+    entry_points={
+        "console_scripts": [
+            "msdl=msdl.__main__:main",
+        ],
+    },
+    include_package_data=True,
+    package_data={
+        "msdl": ["translations/*.yaml", "templates/*"],
+    },
+)

frontend/React/.gitignore

@@ -0,0 +1,25 @@
+
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# production
+/build
+
+# misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+    

frontend/React/.prettierignore

@@ -0,0 +1,7 @@
+dist
+deploy
+values
+node_modules
+.gitignore
+.prettierignore
+.husky

frontend/React/.prettierrc.json

@@ -0,0 +1,7 @@
+{
+    "printWidth": 120,
+    "tabWidth": 4,
+    "singleQuote": true,
+    "quoteProps": "as-needed",
+    "bracketSpacing": true
+}

frontend/React/README.md

@@ -0,0 +1,184 @@
+# Notice
+- If you leave the page (Make the page invisible) and come back again, it will cause sse to reconnect.
+- the project requires Node.js version >= 18.0.0.
+
+# Prepare your dev-environment for frontend
+[Node.js](https://nodejs.org/en)® is a free, open-source, cross-platform JavaScript runtime environment that lets developers create servers, web apps, command line tools and scripts.
+
+# Node.js Installation Guide (Windows, Linux, macOS)
+## Windows Installation
+- Step 1: Download Node.js
+
+  1. Open your web browser and visit the [Node.js official website](https://nodejs.org/en).
+
+  2. Navigate to the "Downloads" section.
+
+  3. Select the desired version (LTS recommended for long-term stability). As of August 2024, the latest LTS version might be v20.x.x.
+
+  4. Click on the "Windows Installer (.msi)" link to download the installation package.
+
+- Step 2: Install Node.js
+
+  1. Double-click the downloaded .msi file to start the installation wizard.
+
+  2. Click "Next" to proceed.
+
+  3. Read and accept the license agreement by checking the "I accept the terms in the License Agreement" box.
+
+  4. Click "Next" again and select the installation directory. It's recommended to change the default location to avoid installing in the C drive.
+
+  5. Continue clicking "Next" to use the default settings until you reach the "Install" button.
+
+  6. Click "Install" to start the installation process.
+
+  7. Wait for the installation to complete and click "Finish" to exit the installation wizard.
+
+- Step 3: Verify Installation
+  1. Open the Command Prompt (cmd) by pressing `Win + R`, typing `cmd`, and pressing Enter.
+  2. Type `node -v` and press Enter. You should see the installed Node.js version displayed.
+  3. Type `npm -v`  and press Enter to verify the installed npm version. npm is the package manager that comes bundled with Node.js.
+
+- Step 4: Configure npm Global Path (Optional)
+  If you want to change the default global installation path for npm, follow these steps:
+
+1. Open the Command Prompt (cmd) as an administrator.
+
+2. Navigate to your Node.js installation directory (e.g., C:\Program Files\nodejs).
+
+3. Create two new folders named node_global and node_cache.
+
+4. Run the following commands to set the new paths:
+
+   ```bash
+   npm config set prefix "C:\Program Files\nodejs\node_global"  
+   npm config set cache "C:\Program Files\nodejs\node_cache"
+   ```
+
+5. Open the Environment Variables settings in the System Properties.
+6. Add `C:\Program Files\nodejs\node_global` to the `PATH` variable under User Variables.
+7. Optionally, create a new system variable named `NODE_PATH` and set its value to ` C:\Program Files\nodejs\node_global\node_modules`.
+
+## Linux Installation
+- Step 1: Update Your System
+  Before installing Node.js, ensure your Linux system is up-to-date:
+
+  ```bash
+  sudo apt-get update  
+  sudo apt-get upgrade
+  ```
+
+- Step 2: Install Dependencies
+  Node.js requires certain dependencies to function properly:
+
+```bash
+sudo apt-get install build-essential libssl-dev
+```
+
+- Step 3: Download and Install Node.js
+  You can download the Node.js source code or use a package manager like `curl` or `wget` to download a pre-built binary. For simplicity, this guide assumes you're using a package manager.
+
+1. Navigate to the Node.js download page for package managers.
+   Follow the instructions for your Linux distribution. For example, on Ubuntu, you can use:
+
+   ```bash
+   curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -  
+   sudo apt-get install -y nodejs
+   ```
+
+   Replace 20.x with the desired version number if you don't want the latest version.
+
+- Step 4: Verify Installation
+  1. Open a terminal.
+  2. Type `node -v` and press Enter to check the Node.js version.
+  3. Type `npm -v` and press Enter to verify the npm version.
+
+
+## Installing Node.js on macOS
+
+Installing Node.js on macOS is a straightforward process that can be accomplished using the official installer from the Node.js website or through package managers like Homebrew. This guide will cover both methods.
+
+### Method 1: Using the Official Installer
+- Visit the Node.js Website
+  - Open your web browser and navigate to https://nodejs.org/.
+- Download the Installer
+  - Scroll down to the "Downloads" section.
+  - Click on the "macOS Installer" button to download the .pkg file. Ensure you download the latest version, which as of August 2024, might be v20.x.x or higher.
+- Install Node.js
+  - Once the download is complete, locate the .pkg file in your Downloads folder.
+  - Double-click the file to start the installation process.
+  - Follow the on-screen instructions. Typically, you'll need to agree to the license agreement, select an installation location (the default is usually fine), and click "Continue" or "Install" until the installation is complete.
+- Verify the Installation
+  - Open the Terminal application by going to "Finder" > "Applications" > "Utilities" > "Terminal" or using Spotlight Search (press `Cmd + Space` and type "Terminal").
+  - Type `node -v` and press Enter. This command should display the installed version of Node.js.
+  - Type `npm -v` and press Enter to verify that npm, the Node.js package manager, is also installed.
+
+### Method 2: Using Homebrew
+If you prefer to use a package manager, Homebrew is a popular choice for macOS.
+
+- Install Homebrew (if not already installed)
+
+  - Open the Terminal.
+
+  - Copy and paste the following command into the Terminal and press Enter:
+    ```bash
+    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+    ```
+
+  - Follow the on-screen instructions to complete the Homebrew installation.
+      
+- Install Node.js with Homebrew
+  - Once Homebrew is installed, update your package list by running brew update in the Terminal.
+  - To install Node.js, run the following command in the Terminal:
+  ```bash
+      brew install node
+  ```
+  - Homebrew will download and install the latest version of Node.js and npm.
+- Verify the Installation
+  - As with the official installer method, you can verify the installation by typing node -v and npm -v in the Terminal and pressing Enter.
+
+### Additional Configuration (Optional)
+- Configure npm's Global Installation Path (if desired):
+  - You may want to change the default location where globally installed npm packages are stored. Follow the steps outlined in the Node.js documentation or search for guides online to configure this.
+- Switch to a Different Node.js Version (if needed):
+  - If you need to switch between multiple Node.js versions, consider using a version manager like nvm (Node Version Manager). Follow the instructions on the nvm GitHub page to install and use it.
+
+
+By following these steps, you should be able to successfully install Node.js on your system. Remember to keep your Node.js and npm versions up-to-date to take advantage of the latest features and security updates.
+
+If your env has been prepared, you can 
+
+# Installation and Setup Instructions
+
+## Installation
+```
+  npm install
+```
+
+## Start Server
+```
+  npm start
+```
+
+## Visit Server
+```
+  http://localhost:8080
+```
+
+pay attention to the real port in your terminal.maybe it won`t be 8080.
+
+# Config
+## How to modify the request URL
+
+- Open the file `vite.config.ts`, modify the target like:
+
+  ```
+    server: {
+      port: 8080,
+      proxy: {
+        "/solve": {
+          target: "{HOST}:{PORT}",
+          changeOrigin: true,
+        }
+      }
+    }
+  ```

frontend/React/README_zh-CN.md

@@ -0,0 +1,135 @@
+# Notice
+问题回答过程中离开页面后再回到页面，会导致sse重连！
+# 开始
+## 请使用大于18.0.0的node版本
+## 准备node.js开发环境
+Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境，允许你在服务器端运行 JavaScript。以下是在 Windows、Linux 和 macOS 上安装 Node.js 的详细步骤。
+
+### 在 Windows 上安装 Node.js
+- 步骤 1: 访问 Node.js 官网
+
+打开浏览器，访问 [Node.js](https://nodejs.org/zh-cn/download/prebuilt-installer) 官方网站。
+
+- 步骤 2: 下载 Node.js 安装包
+
+选择你需要的nodejs版本，设备的类型，点击下载，示例如下图：
+![windows install](./windows-.png)
+
+- 步骤 3: 安装 Node.js
+
+双击下载的安装包开始安装。
+
+跟随安装向导的指示进行安装。在安装过程中，你可以选择安装位置、是否将 Node.js 添加到系统 PATH 环境变量等选项。推荐选择“添加到 PATH”以便在任何地方都能通过命令行访问 Node.js。
+安装完成后，点击“Finish”结束安装。
+
+- 步骤 4: 验证安装
+
+打开命令提示符（CMD）或 PowerShell。
+输入 node -v 并回车，如果系统返回了 Node.js 的版本号，说明安装成功。
+接着，输入 npm -v 并回车，npm 是 Node.js 的包管理器，如果返回了版本号，表示 npm 也已正确安装。
+
+### 在 Linux 上安装 Node.js
+注意： 由于 Linux 发行版众多，以下以 Ubuntu 为例说明，其他发行版（如 CentOS、Debian 等）的安装方式可能略有不同，可自行查询对应的安装办法。
+
+- 步骤 1: 更新你的包管理器
+
+打开终端。
+
+输入 sudo apt update 并回车，以更新 Ubuntu 的包索引。
+
+- 步骤 2: 安装 Node.js
+
+对于 Ubuntu 18.04 及更高版本，Node.js 可以直接从 Ubuntu 的仓库中安装。
+输入 sudo apt install nodejs npm 并回车。
+对于旧版本的 Ubuntu 或需要安装特定版本的 Node.js，你可能需要使用如 NodeSource 这样的第三方仓库。
+
+- 步骤 3: 验证安装
+
+在终端中，输入 node -v 和 npm -v 来验证 Node.js 和 npm 是否已正确安装。
+
+### 在 macOS 上安装 Node.js
+
+#### 下载安装
+- 步骤 1: 访问 Node.js 官网
+
+打开浏览器，访问 Node.js 官方网站。
+
+- 步骤 2: 下载 Node.js 安装包
+
+在首页找到 macOS 对应的安装包（通常是 .pkg 文件），点击下载。
+
+- 步骤 3: 安装 Node.js
+
+找到下载的 .pkg 文件，双击打开。
+跟随安装向导的指示进行安装。
+安装完成后，点击“Close”结束安装。
+
+- 步骤 4: 验证安装
+
+打开终端。
+
+输入 node -v 和 npm -v 来验证 Node.js 和 npm 是否已正确安装。
+
+#### 使用HomeBrew安装
+前提条件：确保你的macOS上已经安装了Homebrew。如果尚未安装，可以通过以下命令进行安装（以终端操作为例）：
+```
+  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+按照提示输入密码以确认安装。安装过程中，可能需要你同意许可协议等。
+
+- 打开终端：
+在macOS上找到并打开“终端”应用程序。
+
+- 使用Homebrew安装Node.js：
+在终端中输入以下命令来安装最新版本的Node.js
+```
+  brew install node
+```
+Homebrew会自动下载Node.js的安装包，并处理相关的依赖项和安装过程。你需要等待一段时间，直到安装完成。
+
+- 验证安装：
+安装完成后，你可以通过输入以下命令来验证Node.js是否成功安装：
+```
+  node -v
+```
+如果终端输出了Node.js的版本号，那么表示安装成功。同时，你也可以通过输入npm -v来验证npm（Node.js的包管理器）是否也成功安装。
+
+完成以上步骤后，你应该能在你的 Windows、Linux 或 macOS 系统上成功安装并运行 Node.js。
+
+### 更多
+如需了解更多，可参照：https://nodejs.org/en
+
+如环境已经准备好，跳转下一步
+
+## 安装依赖
+进入前端项目根目录
+```
+  npm install
+```
+
+## 启动
+```
+  npm start
+```
+
+启动成功后，界面将出现可访问的本地url
+
+## 配置
+### 接口请求配置
+
+- 在vite.config.ts中配置proxy，示例如下：
+
+  ```
+    server: {
+      port: 8080,
+      proxy: {
+        "/solve": {
+          target: "{HOST}:{PORT}",
+          changeOrigin: true,
+        }
+      }
+    }
+  ```
+
+## 知悉
+- 前端服务基于react开发，如需了解react相关知识，可参考：https://react.dev/

frontend/React/index.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title></title>
+  </head>
+
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/index.tsx"></script>
+  </body>
+</html>

frontend/React/package.json

@@ -0,0 +1,55 @@
+{
+	"name": "test-react-flow",
+	"private": true,
+	"version": "0.0.0",
+	"type": "module",
+	"scripts": {
+		"start": "vite --host --mode dev",
+		"start:dev": "vite --host --mode dev",
+		"start:staging": "vite --host --mode staging",
+		"start:prod": "vite --host --mode production",
+		"build": "tsc && vite build",
+		"build:dev": "tsc && vite build --mode dev",
+		"build:staging": "tsc && vite build --mode staging",
+		"build:prod": "tsc && vite build --mode production",
+		"preview": "vite preview",
+		"prettier": "prettier --write ."
+	},
+	"devDependencies": {
+		"@babel/plugin-proposal-optional-chaining": "^7.21.0",
+		"@types/classnames": "^2.3.1",
+		"@types/js-cookie": "^3.0.3",
+		"@types/node": "^18.15.11",
+		"@types/react": "^18.0.28",
+		"@types/react-dom": "^18.0.11",
+		"@vitejs/plugin-legacy": "^4.0.2",
+		"@vitejs/plugin-react": "^3.1.0",
+		"husky": "^9.0.11",
+		"less": "^4.1.3",
+		"lint-staged": "^15.2.7",
+		"prettier": "^3.0.0",
+		"react": "^18.2.0",
+		"react-dom": "^18.2.0",
+		"terser": "^5.16.9",
+		"typescript": "^4.9.3",
+		"vite": "^4.2.1",
+		"vite-babel-plugin": "^0.0.2"
+	},
+	"dependencies": {
+		"@antv/x6": "^2.18.1",
+		"@microsoft/fetch-event-source": "^2.0.1",
+		"antd": "^5.18.3",
+		"axios": "^1.3.5",
+		"classnames": "^2.5.1",
+		"elkjs": "^0.9.3",
+		"js-cookie": "^3.0.1",
+		"react-markdown": "^9.0.1",
+		"react-router": "^6.11.2",
+		"react-router-dom": "^6.11.2",
+		"reactflow": "^11.11.3",
+		"rehype-raw": "^7.0.0"
+	},
+	"lint-staged": {
+		"**/*.{ts, tsx, less, module.less, json, md, .html}": "prettier --write ."
+	}
+}

frontend/React/src/App.module.less

@@ -0,0 +1,52 @@
+.app {
+  height: 100%;
+  display: flex;
+  justify-content: space-between;
+  background: url(./assets/background.png) rgb(247, 248, 255);
+  background-size: cover;
+  overflow: hidden;
+}
+
+.content {
+  padding: 64px 0 16px 0;
+  width: 100%;
+  height: 100%;
+  box-sizing: border-box;
+}
+
+.header {
+  position: fixed;
+  padding: 16px 32px;
+  width: 100%;
+  display: flex;
+  align-items: center;
+  box-sizing: border-box;
+
+  &-nav {
+    flex: 1;
+
+    img {
+      height: 40px;
+    }
+
+    a {
+      display: inline-block;
+      text-decoration: none;
+      color: black;
+
+      &:not(:first-of-type) {
+        margin-left: 40px;
+      }
+
+      &.active {
+        font-weight: bold;
+      }
+    }
+  }
+
+  &-opt {
+    flex-shrink: 0;
+    display: flex;
+    align-items: center;
+  }
+}

frontend/React/src/App.tsx

@@ -0,0 +1,25 @@
+import style from "./App.module.less";
+
+import { BrowserRouter } from "react-router-dom";
+import RouterRoutes from "@/routes/routes";
+import Logo from "@/assets/logo.svg";
+
+function App() {
+  return (
+    <BrowserRouter>
+      <div className={style.app} id="app">
+        <div className={style.header}>
+          <div className={style.headerNav}>
+            <img src={Logo} />
+          </div>
+        </div>
+
+        <div className={style.content}>
+          <RouterRoutes />
+        </div>
+      </div>
+    </BrowserRouter>
+  );
+}
+
+export default App;

frontend/React/src/global.d.ts

@@ -0,0 +1 @@
+declare module 'event-source-polyfill';