A simple open source site hosted via github pages
And via random people contributing a chat room .
Here you can talk to random people with common
Interests, Ideologies, and so on.

Requirements - python3 , pip3/pip , git

Note : If hosting on replit use something like uptimebot to keep it alive

git clone https://github.com/Justct/Chatroom.git

cd Chatroom

If on replit use this instead :

git clone https://github.com/Justct/Chatroom-replit.git && sed -i 's|entrypoint = "main.py"|entrypoint = "Chatroom-replit/main.py"|' .replit

cd Chatroom-replit 

pip install -r requirements.txt

Use python/python3 to run the Chatroom, If on replit use the 'run' button!

python main.py

After doing this register your Room here : https://justct.github.io/creation.html

API url : https://justct.pythonanywhere.com/

Uses GET :

/find/<room name>

• Get API Url of the room in return

/get/int:page/int:results_per_page

• Get the rooms
• Returns : JSON List of rooms + details
• Example return : [ {"name":"chat room 1", "description": ".....", "api_url": "https://......"} ]

/search/string:search_query

• Search for rooms-
• Returns : JSON List of rooms + details
• Example return : [ {"name":"chat room 1", "description": ".....", "api_url": "https://......"} ]

Uses POST :

/new

• Creates A new chat room
• Headers should contain valid name and api_url and description
• Returns -
  • "n" if the api url not working
  • "x" if a room with same name exists
  • "s" if it was a success

• Right now, if you wanna take your room down you have to join our discord and request for removal

Join our discord server to talk about the
project and for giving us suggestions.
Join Server

Project owned and managed by darkmash-org