Deploy JoyAgent: Step‑by‑Step Guide to Launch an Open‑Source AI Agent

Step 1: Create a lightweight cloud host

Use the JoyAgent‑Genie image when ordering a lightweight cloud instance on JD Cloud, select the desired plan and duration, and create the VM.

Step 2: Open ports and obtain the public IP

After payment, locate the instance in the console, note its IP address, and click the view button.

In the firewall settings, add rules to open ports 1601, 3000, and 8080.

Step 3: Configure the model and search engine

Using DeepSeek as the language model and Serper as the search engine, edit the configuration files on the host.

In genie-backend/src/main/resources/application.yml, set the default model (e.g., deepseek-chat).

In genie-tool/.env, provide the model API key, the server IP (the public IP you recorded), and the search engine API key.

In ui/src/utils/querySSE.ts and ui/vite.config.ts, replace the placeholder with the public IP (prefixed by http://).

Step 4: Start the service

Run ./Genie_start.sh and wait until the log shows the service is ready.

Open a browser and navigate to http://{public_ip}:3000 to access the Genie UI (the first load may be slow).