Chesslise is a community-driven, open-source chess bot designed to bring the ultimate chess experience to Discord. Whether you're looking to play, learn, or spectate, Chesslise makes it seamless—all within your Discord server, Group DMs, or friend chat rooms.
🔥 Ranked 2nd in Discord’s official App Directory for Chess, Chesslise is trusted by 1,200+ servers worldwide to deliver an engaging chess experience.
✅ Play Chess Anywhere – Challenge friends or compete in public games directly in Discord.
✅ Learn & Improve – Solve more than 40k chess puzzle. From Lichess Puzzle Database
✅ Watch Live Games – Spectate real-time online matches and follow top players.
✅ Seamless Integration – Works effortlessly in Group DMs, private chats, and community servers.
✅ Stockfish Engine Support – Play Stockfish with group matches, with easy, medium, hard level support.
✅ CSSN – Chesslise Social Server Network – Discover new chess friends, opponents, and challenges.
Chesslise integrates with multiple powerful chess APIs to provide a high-quality experience:
- ♟️ Lichess API
- ♟️ Chess.com API
- ♟️ JDA 5 (Discord API)
- ♟️ Stockfish API
- ♟️ ChessDB CN (Opening Book)
- Language: Java 21
- Build Tool: Maven
- Database: MongoDB
- Hosting: AWS
- Lichess Java Client
- Tors42 JBang-Chariot (Java Client Examples)
- Chess.com Java Wrapper
- Java Chess Library
Follow these steps to set up and run Chesslise on your local machine:
- Clone the repository:
git clone https://github.com/jalpp/Chesslise.git cd Chesslise - Set up beta environment variables:
- Copy the
copy.envfile to.env:
cp copy.env .env
- Fill in the required variables in the
.envfile. Note ignore production Discord token, unless you want to run production/beta bots
- Copy the
- Build the project:
mvn clean install
- Run the bot:
java -jar target/ChessLise-17.0-SNAPSHOT-jar-with-dependencies.jar
- Check bot status:
- if you did everything right, the below should be printed on console, and Chesslise will be online in Discord server
[Chesslise Status]: Beta Successfully Running [Chesslise Status]: Successfully Connected To Database
The bot should now be running locally and can be tested on your Discord server!
you must have the following:
- AWS account
- AWS CLI
- AWS SAM CLI
- Typescript
- BlueSky account
each lambda as sam readme you can follow
Want to contribute? Awesome! 🎉 Check out our CONTRIBUTING.md for setup instructions and guidelines.
🔹 App Directory – View Chesslise on Discord
🔹 Development Discord – Join Our Dev Server
♟️ Let’s bring chess to every Discord server! 🚀