# 部署的详细方法

## 前期准备， 如果java,python,pnpm都满足，直接 FLY Step 1

java > 17

mac用户安装
*. brew install maven

直接安装会同时安装openjava sdk， JAVA_HOME：/opt/homebrew/Cellar/openjdk/24.0.1/libexec/openjdk.jdk/Contents/Home, 如果没有需要手动安装java.

**.下载 https://www.oracle.com/java/technologies/downloads/，版本大于17
手动安装：/usr/libexec/java_home -V
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home

然后通过，写入zshrc

```
echo 'export JAVA_HOME=$(/usr/libexec/java_home)' >> ~/.zshrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
```

pnpm > 7
如何安装pnpm，https://pnpm.io/zh/installation
ps：资源包的安装如果速度比较慢建议使用国内镜像


python

---
## Step 1: 启动前端服务

打开一个终端

cd joyagent-jdgenie/ui && sh start.sh 

如果报错参见上面信息前期准备看看有没有pnpm

出现 Local:   http://localhost:3000/ 即成功！

---
## Step 2: 启动后端服务

另外打开一个终端

cd joyagent-jdgenie/genie-backend && sh build.sh

出现[INFO] BUILD SUCCESS即可
如有报错安装java>17,步骤见上

sh start.sh

启动后，可以通过命令tail -f genie-backend_startup.log观察日志情况。

ps 1: 可以动态适合自己key,编辑 joyagent-jdgenie/genie-backend/src/main/resources/application.yml,其中配置是可以添加多个模型，然后在不同模块下可以指定，比如在react模式下，我指定了claude-3-7-sonnet-v1，建议修改为适合自己的模型名字。
settings: '{"claude-3-7-sonnet-v1": {
        "model": "claude-3-7-sonnet-v1",
        "max_tokens": 8192,
        "temperature": 0,
        "base_url": "<input llm server here>",
        "apikey": "<input llm key here>",
        "max_input_tokens": 128000
}}'

ps 2:修改完配置后，重新build.sh,然后start.sh

---


## Step 3: 启动 tools 服务

另外打开一个终端

```
cd joyagent-jdgenie/genie-tool
pip install uv
cd genie-tool
uv sync
source .venv/bin/activate
```
首次启动需要执行
python -m genie_tool.db.db_engine
之后则无需执行。

然后
cp .env_template .env
编辑.env文件, 其中需要配置SERPER_SEARCH_API_KEY，申请网址https://serper.dev/
最后通过
uv run python server.py 启动服务即可


## Step 4: 启动mcp 服务

另外打开一个终端
cd joyagent-jdgenie/genie-client
uv venv
source .venv/bin/activate
sh start.sh 即可