Skip to content

convos-chat/convos

This branch is up to date with main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

8bc403b Â· Feb 7, 2025
Aug 5, 2024
Mar 18, 2024
Mar 20, 2024
Mar 20, 2024
Mar 20, 2024
Mar 20, 2024
Mar 20, 2024
Oct 27, 2023
Mar 18, 2024
Oct 26, 2019
Sep 29, 2022
Oct 17, 2023
Sep 17, 2020
Oct 17, 2023
Oct 28, 2019
Oct 26, 2019
Jul 19, 2021
Mar 20, 2024
Oct 17, 2023
Nov 24, 2019
Oct 17, 2023
Mar 18, 2024
Oct 17, 2023
Dec 13, 2021
Feb 7, 2025
Feb 7, 2025
Sep 1, 2022
Sep 29, 2022
Oct 17, 2023

Repository files navigation

convos Build Status GitHub issues

Convos - Multiuser chat application

Convos is a multiuser chat application that runs in your web browser.

The supported chat protocol is currently IRC, but Convos can be extended to support other protocols as well.

See convos.chat for more details.

The backend is powered by Mojolicious, while the frontend is held together by the progressive JavaScript framework Svelte.

Quick start guide

See "Getting started" for other options and more information.

Install locally

curl https://convos.chat/install.sh | sh -
./convos/script/convos daemon

That's it! After the two commands above, you can point your browser to http://localhost:3000 and start chatting.

Docker install

You can use the command below to pull and run convos:

docker pull ghcr.io/convos-chat/convos:alpha
mkdir -p $HOME/convos/data
docker run -it -p 8080:3000 -v $HOME/convos/data:/data ghcr.io/convos-chat/convos:alpha

Note that Nordaaker/convos and convos/convos will be around for a while, but the new official image is now hosted at GitHub.

How to make a release

Notes for developers so a new release is made in a proper way.

# Update with the recent changes and make sure the timestamp is proper
$EDITOR Changes

# Build the production assets and update and check that all the files
# have the correct version information
./script/convos build release

Branch overview

main

"main" is for developers. It's mostly stable, but might require extra tools and packages to run. This branch might have outdated assets (JavaScript, CSS files), so it might not work properly.

stable

"stable" is the branch you should use, if you want to clone and run Convos. The JavaScript assets and the Perl code will be in sync here.