README.md

---
license: mit
---
### Hello

Thanks for your interest in the Mmojo Server packages. These are free for your use. These packages are built with 
[llama-server-one](https://github.com/BradHutchings/llama-server-one) and run on macOS, Windows, and Linux on x86 and ARM PCs.
Smaller models will even run on a Rasberry Pi! You should be familiar with running scripts on your computer. 
If you're not, please get help from someone who is.

I make an affordable appliance you can plug into your home router and access Mmojo Server. If you're not comfortable with
running programs on the command line, you should get one. Even if you are, you should get one! 
Please visit [Mmojo.net](https://Mmojo.net) to purchase.

-Brad<br/>
Brad Hutchings<br/>
[email protected]

---

### Mmojo Knowledge Appliance Updgrade Instructions

1. Use VNC to connect to your appliance.
2. On the appliance, open a web browser to this page.
3. Go to the **Files and versions** tab of this web page.
4. Download the **Mmojo-Server-Update-MKA.zip** file.
5. Open a Terminal. Copy these commands and paste into the Terminal:
   ```
   cd ~/Downloads
   unzip Mmojo-Server-Update-MKA.zip
   chmod a+x mmojo-server
   mv mmojo-server ~/Mmojo-LLMs
   ~/Desktop/Choose\ Model.sh
   ```
6. Choose an available model to restart **mmojo-server**.

I'll have a script on the Desktop to do an upgrade soon.

You can download additional models to use from the **models** directory. Place the **.gguf** files in the 
**Mmojo-LLMs** directory. Run the **Choose Model.sh** script on your Desktop to use a different model.

---

### Windows Instructions

1. Go to the **Files and versions** tab of this web page.
2. Download the **Mmojo Server (Windows).zip** file.
3. Once downloaded, move the file to your Desktop and extract there.
4. Open that new folder. Right-click the **mmojo-server.exe** file. Choose **Open**.
   - A Terminal window will open and start the server.
5. Open your web browser and connect to [https://localhost:443](https://localhost:443)
6. When you're finished using Mmojo Server, close the web browser tab and close the Terminal window.

You can download additional models to use from the **models** directory. Place the **.gguf** files in the 
**Mmojo Server (Windows)** directory. Edit line 2 of the **mmojo-server-args** file to use a different model.

---

### macOS, Linux, Raspberry Pi, etc. Instructions
1. Go to the **Files and versions** tab of this web page.
2. Download the **Mmojo Server (macOS-Linux).zip** file.
3. Once downloaded, move the file to your Desktop and extract there.
4. Open a Terminal. Type commands:
   ```
   cd ~/Desktop/Mmojo Server\ \(macOS-Linux\)
   chmod a+x *
   ls -al
   ```
   (Picture of files with x bits set goes here.)
5. Open that new folder. Right-click the **mmojo-server** file. There should be a menu item to "run" the app. Choose that.
   - A Terminal window will open and start the server.
6. Open your web browser and connect to [https://localhost:443](https://localhost:443)
7. When you're finished with the server, close the web browser tab and close the Terminal window.

You can download additional models to use from the **models** directory. Place the **.gguf** files in the 
**Mmojo Server (macOS-Linux)** directory. Edit line 2 of the **mmojo-server-args** file to use a different model.

---

#### macOS Users
- **Note:** When you right-click the `mmojo-server` file, choose **Open** from the context menu that appears.
  You may get a warning about the script. You can allow the script in the privacy settings:<br/>
  https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unknown-developer-mh40616/mac
- **Note:** You may be asked to enable Developer Tools or some such when you launch the Terminal app for the first time.
  If this isn't a familiar place for you, please get some basic help from someone who knows their way around the Terminal.