Skip to content

OmnipotentLabs/communeaisetup

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 

Repository files navigation

First off, this is based on the installation guide made by Visate. Without his steps, I would have been stuck!
For more info regarding many of the below steps. please read more on his page.

https://github.com/Visate/communeai-scratchpad

Setup Commune on Windows 10 Pro/Enterprise without Docker Desktop

YouTube version.
https://youtu.be/XyiW0suKqyo

(for the people that would like to know what you are installing, you can find links at the bottom of the page)

Prerequisites

Your IP needs to be a public IP (as in not behind a nat) and ensure you have setup port forwarding rules. Otherwise, Commune will not work! See step 9 for more details.

1. Setup WSL and Ubuntu

  • Right click the Start menu and open Windows Powershell (admin).
  • First set the default version of WSL.
wsl --set-default-version 2
  • Make sure WSL is up to date.
wsl --update
  • Install Ubuntu 22.04
  • During the installation, set user and password and remember them!
wsl --install -d Ubuntu-22.04 
  • We could continue directly from here but it is good to check if all is working, so let's close the Powershell window.

2. Start Ubuntu and update

  • Click on the Start menu and start Ubuntu, there should now be a shortcut for Ubuntu in the Start menu.
  • Let's start with updating and upgrading our installation.
sudo apt update && sudo apt -y upgrade

If you see a message regarding libcuda.so, you can ignore this. It is just a warning.

3. Install dependencies

  • Install pip
sudo apt install -y python3-pip
  • Install pipenv
pip install pipenv --user
  • Check path (result for me: /home/omni/.local)
python3 -m site --user-base
  • Update path, append /bin to the above path. Replace omni with your username.
export PATH="/home/omni/.local/bin:$PATH"
  • Permanently add to the path
nano ~/.bashrc 
  • This opens Nano text editor, use the arrow keys on your keyboard and go down to the end of the file.
  • Paste or write (export PATH="$HOME/.local/bin:$PATH") without () at the end of the file, if you are new to Nano, one right-click will paste where the cursor is.
  • Once you have added the above line, press CTRL + x, answer Y and press enter to save and overwrite.

  • Install dependencies.
pipenv install click numpy protobuf==3.20 streamlit

4. Starting pipenv

  • Start pipenv
pipenv shell

5. Setup/installing Commune

  • Clone Commune Git
git clone https://github.com/commune-ai/commune.git
  • Change directory
cd commune
  • Pull latest files
make pull
  • Run install for commune
pip install -e ./

6. Install and configure Rust

  • Run the below commands, one after the other.
curl https://sh.rustup.rs -sSf | sh -s -- -y
source "$HOME/.cargo/env"
rustup install nightly-2023-01-01
rustup override set nightly-2023-01-01
rustup target add wasm32-unknown-unknown

7. Make sure you are the owner of the commune folder

  • Replace omni with your username
sudo chown -R omni:omni ~/.commune

8. Is commune running?

  • You should still be in the ~/commune folder. (~/ This is a shortcut to your home folder).
  • Let's see if you can list the modules.
c modules
  • If you could see a list of modules, congratulations!, commune is now working!

9. Set port range

  • Now that we know that Commune is running, lets set the port range for Commune (this is the ports you need to set in the port forward rule).
  • The blow range is just an example.
c set_port_range 50000 55000 
  • If you could see a list of modules, congratulations!, commune is now working!

10. Some extra commune commands.

  • Find your root key, this is good to save.
c root_key
  • You can start a local node if you need to. There could be some extra configuration depending on your system, see below for more info.
c start_local_node

11. How to start Commune the second time

  • If you want to or need to get back into Commune and use it, do the following.
  • Start Ubuntu from the Start menu.
  • Open the commune folder
cd commune
  • Start the pipenv
pipenv shell
  • From here you can use any of the commune commands i.e. c mcap, c stats and so on.
  • Best of luck!



12. Extra steps, if you want to run a local node.

  • Before you begin the below steps, you need to reboot at least once after completing the above steps and setting up Commune.
  • Install Docker
sudo apt install docker.io
  • Add your user to docker group
sudo usermod -aG docker $USER
  • REBOOT Windows!!, do not skip this step.
  • Go to the commune folder
  • Start the pipenv
pipenv shell
  • Enter commune folder
cd ~/commune/
  • Start local node
c start_local_node

13. Troubleshooting

  • If you have issues installing Ubuntu on step 1, run the four below commands and reboot your computer.
wsl --unregister Ubuntu-22.04
wsl --shutdown
netsh winsock reset
netsh int ip reset
  • If you see an error like this "fatal: No url found for submodule path 'comchat' in .gitmodules" when you try make pull, run this and try again.
git rm --cached comchat
  • If you see this error in the dashboard KeyError: 'module', enter the below and try starting the cash again.
c dash public=true
c st public=true

14. For the people that would like to know what they are installing.

About

Setup guide for CommuneAI on Windows

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published