We provide a portable version for Windows x64, which uses SQLite as the database by default. After unzipping, the required packages will take up about 1.5GB. Please pay attention to your data usage.
Please follow the steps below to install:
- Make sure you have already installed VC_redist.exe
- If you want to load models on GPU, please install CUDA first.
- Gemini Pro and ChatGPT are enabled by default. If you need to run the gguf model, please drop it in the path: executors\llamacpp.
- The process will create an admin account. If you need a new one, please refer to the first item in FAQs.
git clone https://github.com/kuwaai/genai-os.git
cd genai-os/windows
"build & start.bat"
- Enter the
stop
command to close the system. Directly closing the window may fail to release memory usage. If you accidentally closed the window, please refer to the third item in FAQs. - You can directly run
start.bat
for subsequent startup. If there is an update or the project path is moved, please rerunbuild.bat
orbuild & start.bat
.
-
Download from Release, or execute the following command in git bash to clone the project and switch to the windows folder in the project:
git clone https://github.com/kuwaai/genai-os.git cd genai-os/windows
-
Download the related packages and set up quickly:
.\build.bat
-
Start the application:
- Run
start.bat
to start the application. Note: If you have any of the following services running (nginx, php, php-cgi, python, redis-server), this executable will terminate them when closed. Please also make sure that ports 80, 9000, and 6379 are not being used.
.\start.bat
- At this point, you should be asked to create an administrator account (you will need to enter a name, email address, and password). If it does not pop up or you enter it incorrectly or fail to create it, please see here.
- Run
-
Check the application status:
- If successful, your browser will automatically open to
127.0.0.1
. If you see the web interface, the installation should be successful.
- If successful, your browser will automatically open to
-
How to close the program:
-
Please try not to force close the .bat file (including using the red cross to close it directly). Currently, due to the .bat file, it cannot automatically close all open programs to release resources in these situations.
-
Therefore, please develop the habit of entering
stop
when executingstart.bat
to close the program.
-
-
Set up models:
- By default, ChatGPT and Gemini Pro are preset when the program is just started. Both models are connected to the API, so you need to apply for the corresponding API Key. If you want to start your own model or connect to other APIs, you need to set up executors. However, since this part is extensive, please refer to the tutorial guide here.
-
Q: I was not asked to create an administrator account, the administrator account creation failed, or I entered it incorrectly...
A: Please open
tool.bat
, then enterseed
to open the administrator account creation interface. Enterquit
to close after creation. -
Q: After moving the entire project, I got a bunch of errors when executing start.bat, and the webpage was 404/500 and could not be accessed.
A: Since some parts of the project must use absolute paths, if the path to the project directory has changed (a change in the name of the parent folder or the moving of the entire project), you will need to rerun
build.bat
to update the absolute path, and so does the model in the workers folder. It is recommended to reruninit.bat
to avoid errors. -
Q: I accidentally closed the entire start.bat program by directly clicking the red cross; the background program was not closed, and the memory resources are still occupied. What should I do?
A: Due to the .bat file, it cannot close all programs when you click the red cross. You can open
tool.bat
and enterstop
to terminate all related programs.
Please feel free to contact us if you encounter any problems during the installation.