{"id":23480591,"url":"https://github.com/farazkh80/wchat","last_synced_at":"2025-06-16T01:36:45.597Z","repository":{"id":156658493,"uuid":"286384546","full_name":"farazkh80/wchat","owner":"farazkh80","description":"WChat is a group chat app developed in python using flask framework and modules on the back end as well as HTML/CSS, and JavaScript on the front end.","archived":false,"fork":false,"pushed_at":"2021-01-09T19:53:39.000Z","size":12988,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-13T21:14:46.421Z","etag":null,"topics":["chat-application","flask-application","socket-io","web-application"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/farazkh80.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-10T05:30:48.000Z","updated_at":"2021-05-23T19:38:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"2dd87739-582c-4a56-a006-956c7ceb29a1","html_url":"https://github.com/farazkh80/wchat","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/farazkh80/wchat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farazkh80%2Fwchat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farazkh80%2Fwchat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farazkh80%2Fwchat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farazkh80%2Fwchat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/farazkh80","download_url":"https://codeload.github.com/farazkh80/wchat/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farazkh80%2Fwchat/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260081926,"owners_count":22956211,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chat-application","flask-application","socket-io","web-application"],"created_at":"2024-12-24T20:17:25.385Z","updated_at":"2025-06-16T01:36:45.585Z","avatar_url":"https://github.com/farazkh80.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WCHAT\nWChat is a multi-socket group chat app, developed with \u003cb\u003ePython's Flask\u003c/b\u003e framework and modules on the backend as well as pure \u003cb\u003eJavaScript\u003c/b\u003e  and a responsive \u003cb\u003eBootstrap\u003c/b\u003e design on the frontend.\n\n\n## Link to heroku live app\n\nhttps://rchat-app80.herokuapp.com/\n\n\n## Configuration\n \nFirst navigate through the terminal to this projects folder\nand enter the following command\n```\n$ python get-pip.py\n```\nThen make sure all the required modules listed iin requirements.txt file are installed on your machine.\nFor manual installation enter the following command.\n```\n$ pip3 install moduleName\n```\nMake sure that you have install virtual environment, if not use the following command\n```\n$ pip3 install virtualenv\n```\nOn your project folder enter the following commands in order to create a virtual environment.\n\n```bash\nvirtualenv venv\n```\n\nNext, activate your virtual environment using the following command.\n\n```bash\nvev/Scripts/activate\n```\n\nInstall the requirements using the following command.\n\n```bash\npip install -r requirements.txt\n```\n\nMake a few adjustment on the code at application.py file:\n\n1- Change the database secret key and url according to their comments above of them (can be found from line 10 to 17 on application.py)\n\n\n```python\n# actual secret key if running on a local system =\u003e \"b'0\\x17\\xdb\\x03\\xdc\\x0c;ja\\xecv\\xb0a\\xe9$\\x13'\"\napp.secret_key = app.secret_key = os.environ.get(\"SECRET\")\n\n\n# configure database\n# Actual Database url if running on a local system =\u003e \"postgres://xwawslekazwoni:ba0ee8e746269e7cc8ff5804aa28c3205e0309757bb2673ffad22d793bb13b92@ec2-34-225-162-157.compute-1.amazonaws.com:5432/dcqg3bakntjhp\"\napp.config[\n    'SQLALCHEMY_DATABASE_URI'] = os.environ.get(\"DATABASE_URL\")\n```\n\n2- Change the last line of code on application.py according to the guide below.\n```python\n# remove the code below and use \"socketio.run(app, debug=True)\" if running on a local system\napp.run()\n```\n\n## Running\n\nTo run your project enter the following command.\n\n```\npython application.py\n```\n\n\nYou will be directed to a registration page first.\n\n![Registration Page](/visuals/reg-page.PNG)\n\n\nAfter completing the registration you will be required to login with your credentials.\n\n![Login Page](/visuals/login-page.PNG)\n\n\nUpon logging in, you will be able to use different chat rooms to talk with the online users.\n\n![Chat Room](/visuals/chat-room.PNG)\n\n\n\n## Contributing\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\nPlease make sure to update tests as appropriate.\n\n\n\n## Future Improvements\n\n1- The main future goal is to connect WChat to a MongoDB database in order save previous messages.\n\n2- Another possible feature is offering users a way to connect with other users through unique username search. \n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarazkh80%2Fwchat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffarazkh80%2Fwchat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarazkh80%2Fwchat/lists"}