Skip to content

Commit

Permalink
Dev docs (#81)
Browse files Browse the repository at this point in the history
* Add Development to docs

* Update docs
  • Loading branch information
justinh-rahb authored Sep 4, 2023
1 parent 2929993 commit 34e8ab7
Show file tree
Hide file tree
Showing 11 changed files with 358 additions and 6 deletions.
166 changes: 165 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,10 @@

## 📖 Table of Contents
- [🛠️ Setup](#%EF%B8%8F-setup)
- [👷 Development](#-development)
- [Ubuntu 🤓](#ubuntu-)
- [macOS 🍎](#macos-)
- [Android 🤖](#android-)
- [🧑‍💻 Usage](#-usage)
- [Commands ⌨️](#%EF%B8%8F-commands)
- [🛡️ Privacy](#%EF%B8%8F-privacy)
Expand Down Expand Up @@ -77,7 +81,7 @@ In your GitHub repository:
- `IMAGE_SIZE`: This sets the image size for the DALL-E API. Default: "512x512".
- `API_URL`: This sets the API endpoint for the chat completions API. Default: "https://api.openai.com/v1/chat/completions".
- `ELEVENLABS_API_KEY`: Your ElevenLabs API key. Can be disabled by omitting this secret.
- `ELEVENLABS_MODEL_NAME`: ElevenLabs model you're using. Default: "eleven_monolingual_v1".
- `ELEVENLABS_MODEL_NAME`: ElevenLabs model you're using. Default: "eleven_multilingual_v1".
- `GCS_BUCKET_NAME`: Your chosen name for the GCS bucket meant for TTS audio file storage.

**5. GitHub Actions 🚀**
Expand All @@ -94,6 +98,166 @@ The bot's deployment to Google Cloud Functions and Storage gets automatically ha

Now, your bot can be added to any room within your Google Workspace.

## 👷 Development

The `test_server.py` script included in this repository serves as a lightweight, local development server for Chat²GPT. This enables you to test new features, debug issues, or get a firsthand experience of the chatbot's capabilities without deploying it to a production environment. Running the test server starts a web service that you can access at [http://127.0.0.1:5000](http://127.0.0.1:5000).

### Ubuntu 🤓

To run Chat²GPT on Ubuntu, follow these steps:

1. **Update Packages**

Open Terminal and update your package list:

```bash
sudo apt update
```

2. **Install Required Dependencies**

Install Python and other necessary packages:

```bash
sudo apt install python3 python3-pip git
```

3. **Clone the Repository**

Clone the Chat²GPT repository:

```bash
git clone https://github.com/RAHB-REALTORS-Association/chat2gpt.git
```

Navigate to the cloned directory:

```bash
cd chat2gpt
```

4. **Install Python Packages**

Install the required Python packages:

```bash
pip3 install -r requirements.txt
```

5. **Run the Test Server**

Start the Chat²GPT server:

```bash
python3 test_server.py
```

The server should start successfully and can be accessed at [http://127.0.0.1:5000](http://127.0.0.1:5000).

### macOS 🍎

To run Chat²GPT on macOS, you can use Homebrew to manage your packages. Follow these steps:

1. **Install Homebrew**

If you don't have Homebrew installed, open Terminal and run:
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
2. **Install Python**
Install Python using Homebrew:
```bash
brew install python
```
3. **Clone the Repository**
Clone the Chat²GPT repository:
```bash
git clone https://github.com/RAHB-REALTORS-Association/chat2gpt.git
```
Navigate to the cloned directory:
```bash
cd chat2gpt
```
4. **Install Python Packages**
Install the required Python packages:
```bash
pip3 install -r requirements.txt
```
5. **Run the Test Server**
Start the Chat²GPT server:
```bash
python3 test_server.py
```
The server should start successfully and can be accessed at [http://127.0.0.1:5000](http://127.0.0.1:5000).
### Android 🤖
To run Chat²GPT on an Android device using Termux, follow these steps:
1. **Update and Upgrade Termux Packages**
Open Termux and run the following command to update and upgrade existing packages:
```bash
pkg upgrade
```
2. **Install Required Dependencies**
Install the necessary packages like OpenSSL, Python, pip, Git, Rust, and Binutils by executing:
```bash
pkg install openssl python python-pip git rust binutils
```
3. **Clone the Repository**
Use the `git` command to clone the Chat²GPT repository to your device:
```bash
git clone https://github.com/RAHB-REALTORS-Association/chat2gpt.git
```
Navigate to the cloned directory:
```bash
cd chat2gpt
```
4. **Install Python Packages**
Run the following command to install the Python packages required for Chat²GPT:
```bash
pip install -r requirements.txt
```
5. **Run the Test Server**
Finally, start the Chat²GPT server using the `python` command:
```bash
python test_server.py
```
The server should start successfully and can be accessed at [http://127.0.0.1:5000](http://127.0.0.1:5000).
## 🧑‍💻 Usage
- **Dynamic Interactions:** Chat²GPT is attentive to its surroundings. You can invoke it in chat rooms by directly mentioning it using `@botname`. Alternatively, for more private interactions or queries, you can send a direct message to the bot.
Expand Down
2 changes: 1 addition & 1 deletion docs/community.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "🌐 Community"
layout: page
nav_order: 4
nav_order: 5
---

# 🌐 Community
Expand Down
10 changes: 10 additions & 0 deletions docs/development/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
title: "👷 Development"
layout: page
nav_order: 2
has_children: true
---

# 👷 Development

The `test_server.py` script included in this repository serves as a lightweight, local development server for Chat²GPT. This enables you to test new features, debug issues, or get a firsthand experience of the chatbot's capabilities without deploying it to a production environment. Running the test server starts a web service that you can access at [http://127.0.0.1:5000](http://127.0.0.1:5000).
58 changes: 58 additions & 0 deletions docs/development/macos.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
layout: default
title: macOS
parent: 👷 Development
nav_order: 2
---

## macOS 🍎

To run Chat²GPT on macOS, you can use Homebrew to manage your packages. Follow these steps:

1. **Install Homebrew**

If you don't have Homebrew installed, open Terminal and run:

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

2. **Install Python**

Install Python using Homebrew:

```bash
brew install python
```

3. **Clone the Repository**

Clone the Chat²GPT repository:

```bash
git clone https://github.com/RAHB-REALTORS-Association/chat2gpt.git
```

Navigate to the cloned directory:

```bash
cd chat2gpt
```

4. **Install Python Packages**

Install the required Python packages:

```bash
pip3 install -r requirements.txt
```

5. **Run the Test Server**

Start the Chat²GPT server:

```bash
python3 test_server.py
```

The server should start successfully and can be accessed at [http://127.0.0.1:5000](http://127.0.0.1:5000).
58 changes: 58 additions & 0 deletions docs/development/termux.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
layout: default
title: Android
parent: 👷 Development
nav_order: 3
---

## Android 🤖

To run Chat²GPT on an Android device using Termux, follow these steps:

1. **Update and Upgrade Termux Packages**

Open Termux and run the following command to update and upgrade existing packages:

```bash
pkg upgrade
```

2. **Install Required Dependencies**

Install the necessary packages like OpenSSL, Python, pip, Git, Rust, and Binutils by executing:

```bash
pkg install openssl python python-pip git rust binutils
```

3. **Clone the Repository**

Use the `git` command to clone the Chat²GPT repository to your device:

```bash
git clone https://github.com/RAHB-REALTORS-Association/chat2gpt.git
```

Navigate to the cloned directory:

```bash
cd chat2gpt
```

4. **Install Python Packages**

Run the following command to install the Python packages required for Chat²GPT:

```bash
pip install -r requirements.txt
```

5. **Run the Test Server**

Finally, start the Chat²GPT server using the `python` command:

```bash
python test_server.py
```

The server should start successfully and can be accessed at [http://127.0.0.1:5000](http://127.0.0.1:5000).
58 changes: 58 additions & 0 deletions docs/development/ubuntu.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
layout: default
title: Ubuntu
parent: 👷 Development
nav_order: 1
---

## Ubuntu 🤓

To run Chat²GPT on Ubuntu, follow these steps:

1. **Update Packages**

Open Terminal and update your package list:

```bash
sudo apt update
```

2. **Install Required Dependencies**

Install Python and other necessary packages:

```bash
sudo apt install python3 python3-pip git
```

3. **Clone the Repository**

Clone the Chat²GPT repository:

```bash
git clone https://github.com/RAHB-REALTORS-Association/chat2gpt.git
```

Navigate to the cloned directory:

```bash
cd chat2gpt
```

4. **Install Python Packages**

Install the required Python packages:

```bash
pip3 install -r requirements.txt
```

5. **Run the Test Server**

Start the Chat²GPT server:

```bash
python3 test_server.py
```

The server should start successfully and can be accessed at [http://127.0.0.1:5000](http://127.0.0.1:5000).
4 changes: 4 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,10 @@ nav_order: 0

## 📖 Table of Contents
- [🛠️ Setup](setup.html)
- [👷 Development](development/)
- [Ubuntu 🤓](development/ubuntu.html)
- [macOS 🍎](development/macos.html)
- [Android 🤖](development/termux.html)
- [🧑‍💻 Usage](usage/)
- [Commands ⌨️](usage/help.html)
- [🛡️ Privacy](privacy.html)
Expand Down
Loading

0 comments on commit 34e8ab7

Please sign in to comment.