Skip to content

boandme/ChessIQ

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

30 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

โ™Ÿ๏ธ ChessIQ

ChessIQ is a positional training tool designed for intermediate and advanced chess players who want to improve their ability to visualize, evaluate, and understand chess positions beyond tactics.

Instead of finding a forced move like in traditional tactical puzzles, ChessIQ challenges players to judge the position itself using strategic concepts such as material balance, space, initiative, king safety, and piece activity.

Think of ChessIQ as tactical puzzles for positional thinking.

Status: ๐Ÿšง Currently in beta, with active development leading up to v1.5

๐Ÿง  Core Concept

  • Analyze a given chess position
  • Evaluate the position without engine assistance
  • Decide which side stands better using positional understanding
  • Receive feedback based on engine evaluations from real games

๐Ÿš€ Main Features

๐ŸŽฏ PositionPuzzler (Core Product)

  • Real-game positions sourced from Lichess
  • Evaluate whether White is better, Black is better, or the position is equal
  • Hone your positional skills just as you do tactical skills with regular puzzles
  • Designed to improve evaluation accuracy rather than calculation depth

๐Ÿ”ฎ Upcoming Features

  • AI opponents trained on real games
  • Difficulty-based positional challenges
  • Precomputed explanations for each position, leading to further learning opportunities

๐Ÿ•น๏ธ How to Play

  1. You will be shown a chess position
  2. Analyze the position using positional concepts
  3. Submit your evaluation:
    • โ™” Click the White King if White is winning
    • โ™š Click the Black King if Black is winning
    • โš–๏ธ Click the Equal symbol if the position is roughly equal

๐Ÿ—‚๏ธ Version History and Roadmap

โœ… Released Versions

v0.1 โ€“ Initial HTML Update ๐Ÿ“ฑ

  • Added SVG chess positions
  • Python-based evaluation preprocessing

v0.2 โ€“ Database Update ๐Ÿ’ป

  • Connected evaluations and positions to Firebase
  • Removed the need for continuous Python execution
  • Frontend dynamically loads data using JavaScript, CSS, and HTML

v0.25 โ€“ Gamification Update ๐ŸŽฎ

  • Introduced the guessing mechanic
  • Implemented Stockfish-based evaluation thresholds

v0.3 โ€“ First Fully Working Version ๐Ÿฅ‡

  • Integrated real Lichess game data using Pythonโ€™s berserk library
  • Positions exported to Firebase
  • Added a side-to-move indicator for realistic training

v0.35 โ€“ Accessibility Update โ“

  • Added a help menu and startup guide
  • Improved onboarding and usability

v0.4 โ€“ First Public Release ๐ŸŒ

  • Published the application
  • Upgraded UI and UX across the entire app
  • Added credits and information pages

v0.43 - UI fixes, Evaluation display

  • Added a display of the exact evaluation after the user makes their guess, allowing for more reflection and learning opportunities of positional thinking
  • Upgraded UI across the whole app, including credits, info, and home pages all syncing in similar styles
  • Added a sidebar menu for future other products under ChessIQ <<<<<<< HEAD

v0.45 โ€“ Larger Dataset ๐Ÿ“ˆ

  • Expand the position database by almost 10x, from 100 to over 900.
  • Increase positional diversity and coverage

v0.5 โ€“ Difficulty Modes Update ๐Ÿงฉ

  • Introduce Easy, Medium, and Hard modes
  • Backend filtering by positional complexity using an [algorithm]

v0.6 - Primitive Point System ๐Ÿฅ‡

  • Localstorage-based primitive elo system
  • Complex mechanics and equations for computing elo based on streaks, confidence intervals, etc

v0.8 - Full glow up of main play page

  • matches a vibrant theme - change-up from green theme to yellow/black blend of modern look.

v0.85 - login-free play + UI updates

  • players can play a bit of puzzles onload before hacing to login/create acc -smoother transitions of main pages

v0.9 โ€“ Accounts and Leaderboards Full release๐Ÿ‘ค (June 2026)

  • User accounts and authentication - [done]
  • Score tracking and long-term progress analytics[done]
  • Global leaderboards of PR(Positional Rating) already instated above in earlier updates[done]
  • Google integrations for logins[done]
  • Full statistics overview page[done]

v0.95 - Time-based and point system upgrades, Stats page upgrade ๐Ÿ†[DELAYED to ????]

  • More synced multiplayer point systems reliant on what difficulty puzzles, as well as time
  • Formula-based puzzle calculations
  • upgrade stats page to have specific logistics/trends based on time OR last 'x' puzzles completed, more specification for training purposes.

v1.0 โ€“ Full Release ๐ŸŽ‰ (2026)

  • Official launch
  • Complete feature set with polished performance and UX
  • MAJOR UI POLISH all around, transitios upgrade
  • security terms & privacy terms - prevent issues
  • Lichess & Devpost Release
  • Further publication
  • [optional] - in stats/training page, show the last x positions solved in a log format, their eval, answer, rating change, etc
  • Puzzle review log
  • Mystery feaatures?
  • Updated PR(Positional Rating Calculations) out based on relative puzzle difficulty and accuracy

๐Ÿ”œ Planned Updates

v1.1 - Achievements update(2026-27)

  • Users collect achievements as they solve
  • All collected and notcollected achievements visible on a page
  • rewards player for Personal Best

v1.2 - New gamemode: Regular & blitz-paced modes update

  • On homescreen, ability to switch between regular, rated play
  • OR a new gamemode: Rush(3 or 5 min), where you try to get the most amt of puzzles correct in the limited time as possible.
  • Integrations with global leaderboard - seperate leaderboard for Rush

v1.3 - Friends & Personalization Update(2026) ๐Ÿ‘ฑ

  • Ability to add friends
  • Leaderboards within friends
  • Personalization such as dark/light mode, super beginner mode
  • Daily rewards, streaks, etc

v1.5 - AI-based Explanations & Reflections(2026-27) ๐Ÿค–

  • Pre-cached explanations for each stored position in the database
  • Good for long-term learning and reflection, leading to better opportunities for the user to hone positional skill.

IN THE NEAR FUTURE: COMING TO MOBILE DEVICES!!! --> Both Android & Apple

๐Ÿ’ก Future Ideas

  • Position Accuracy heatmap after user guessed; shows the percent of people that put white equal or black after guessing --> good for user retainment
  • Player recognition + reward for getting a personal best!
  • Crowdsourcing: Randomly after a certain amount of puzzles completed, survey the player on what convinced them of the answer - material, position, etc --> not for ALL though
  • Two main modes of the game: Normal rating play, unrated puzzle streak timed(3min, 5min )- see how much you can get
  • ๐Ÿ“š Positional theme tagging (isolated pawns, bishop pair, space advantage)
  • ๐ŸŽ“ Beginner mode with post-guess explanations
  • ๐Ÿ” Daily challenge positions โ†’ revealed at midnight, distributions also revealed
  • (1.5+) Evaluation Bar Guesser instead of white/black/equal
  • Positional theme tagging on puzzles in the model; Will take a while to pre-train
  • ๐Ÿง  Optional engine explanation after each guess
  • ๐ŸŒ™ Dark mode and board theme customization
  • ๐Ÿ† Add a friend system after multiplayer: โ†’ Global or friends-only leaderboards
  • ๐Ÿ“ฑ (2027) โ†’ Mobile-first UI optimizations

๐Ÿ™ Credits

  • Idea and Development: Boandme
  • Testing: EntyXD
  • Icons and Symbols: UXWing
  • Data: Lichess API

About

A positional chess training tool that helps players evaluate real-game positions using strategic concepts instead of tactics.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors