🤖 A Simple Wrapper for the Unowhy Support Chat

Tested on Windows 11 with Python 3.11.9, using a free Google Cloud server running 3proxy.

---

🚀 Installation

Clone the repository:

git clone https://git.ulysse.gl/Ulysse/Unowhy-Discord-Chatbot.git
cd Unowhy-Discord-Chatbot

🔵 Windows

Create a virtual environment:

python3 -m venv env
.\env\Scripts\activate.bat

Install dependencies:

pip install requests py-cord aiohttp aiohttp[socks] asyncio g4f[all]

🐧 Linux / 🍏 macOS

Create a virtual environment:

python3 -m venv env
source env/bin/activate

Install dependencies:

pip install -r requirements.txt

---

🌐 Configure 3proxy

Add the following to your docker-compose.yml file:

services:
  3proxy:
    image: ghcr.io/tarampampam/3proxy:latest
    ports:
      - "8080:8080"    # HTTP Proxy Port
      - "8888:8888"    # SOCKS Proxy Port
    environment:
      PROXY_LOGIN: "ulysse" # Put your own login
      PROXY_PASSWORD: "changeme" # Put your own password
      MAX_CONNECTIONS: 2056
      PROXY_PORT: 8080
      SOCKS_PORT: 8888

Run the proxy:

docker-compose up -d

---

🛠️ Install Docker Compose

🔵 Windows

1. Download Docker Compose

   • Docker Compose is now included in Docker Desktop for Windows. If you don’t have Docker Desktop installed, download it here.

2. Install Docker Compose

   • Once Docker Desktop is installed, Docker Compose will be available automatically. You can verify the installation by running:

     docker-compose --version
     

   • This will display the version of Docker Compose installed.

🐧 Linux

1. Download Docker Compose

   • Download the latest version of Docker Compose with the following command:

     sudo curl -L "https://github.com/docker/compose/releases/download/$(curl -s https://api.github.com/repos/docker/compose/releases/latest | jq -r .tag_name)/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
     

2. Set Permissions

   • Make the Docker Compose binary executable:

     sudo chmod +x /usr/local/bin/docker-compose
     

3. Verify Installation

   • Check if Docker Compose is installed correctly:

     docker-compose --version
     

🍏 macOS

1. Install Homebrew

   • If you don’t have Homebrew installed, you can install it using:

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
     

2. Install Docker Compose

   • Once Homebrew is installed, run the following command to install Docker Compose:

     brew install docker-compose
     

3. Verify Installation

   • Check if Docker Compose is installed correctly:

     docker-compose --version
     

---

🎯 Usage

1. Rename the default configuration file(config.default.json) to config.json.

2. Place your 3proxy server IP address and your credentials in the config.json.

3. Place your bot's token in the config.json.

4. Follow these instructions file to add emojis to your bot.

5. Activate the virtual environment:

   • Windows:

     .\env\Scripts\activate.bat
     

   • Linux / macOS:

     source env/bin/activate
     

6. Start the bot:

   python3 app.py
   

❗ Important: Do not run sav.py directly.

• sav.py: Contains logic for communication with Unowhy servers.
• app.py: Manages the Discord bot functionality.

8. Invite the bot to your server, you can do this by following the instructions here.
9. Create 2 categories in your server, one for Archives and one for SAV, put their Ids in the config.json file.
10. Continue tweaking the bot to your liking.
11. Enjoy!

---

✨ Features

• ✅ Send messages
• ✅ Send files in the chat
• ✅ Perform actions
• ✅ Submit forms
• ✅ Retrieve messages
• ✅ Retrieve files
• ✅ Retrieve polls
• ✅ Retrieve actions
• ✅ Retrieve forms
• ✅ Automatic conversation with AI
• ✅ Discord views for nicer UI/UX
• ✅ Generate a transcript of the conversation (Web)
• ✅ Collection of SAV Agent like a Pokédex
• ✅ WebSocket and real-time chat
• ✅ Display when the SAV agent is typing
• ✅ Generate fake user infos for IA and consistency (IFP, SCHOOL, NAME, EMAIL)
• ✅ Generate real IFPs
• ✅ See the live chat in your browser using the provided chrome extension and the /browser command
• ✅ Many more features...