Skip to content

Maia Platform v1 Launch#12

Merged
kevinjosethomas merged 276 commits into
mainfrom
v1
Jul 11, 2025
Merged

Maia Platform v1 Launch#12
kevinjosethomas merged 276 commits into
mainfrom
v1

Conversation

@kevinjosethomas
Copy link
Copy Markdown
Collaborator

@kevinjosethomas kevinjosethomas commented Jun 30, 2025

Version 1.0 includes major changes across all core functionalities, beginning with the introduction of the Maia 2 model. These updates affect every part of the user experience and introduce new tools for analysis, training, and gameplay exploration.

Introducing the Maia 2 Model

The most substantial change in v1 is the adoption of the new Maia 2 model, a new version of our neural network trained to predict human moves at various rating levels. As a unified model, Maia 2 has improved predictive accuracy and generalization, as well as consistent coherence across all rating levels. You can read more about the model in our research paper.

This model underpins nearly every page of the platform and enables tighter integration with Stockfish evaluations. You can now see each move through two lenses: one rooted in traditional engine evaluation and one informed by how humans are likely to play. This dual perspective provides more contextually grounded feedback, helping you understand not only what was wrong with a move but also how it compares to the decisions typical of players at different skill levels.

New Analysis Page

analysis

The analysis page has been restructured to make use of Maia 2 and expose deeper feedback mechanisms highlighting the relationship between engine accuracy and human-like play. New components and functionalities include:

  1. Insight Panel: Presents a combined Maia and Stockfish breakdown of move quality and intention. This helps you understand the relationship between engine accuracy and human-like play.
  2. Moves by Rating Graph: Displays the likelihood of each candidate move being played by humans at different rating levels. This helps you understand which moves are typical at different skill levels, and how moves improve as players get stronger.
  3. Blunder Meter: Highlights sharp drops in move quality based on both engine and human-aligned expectations. This helps you understand the difficulty of the position, while also showing you how a player of the specified rating level makes good, okay, and bad moves.
  4. Move Map: A revamped interactive scatter plot that shows move popularity and divergence across ratings. This blends engine accuracy with human-like play, and helps you understand the relationship between optimal and human-like play.

In addition to the new analysis features, you are also able to load custom games by inputting PGN or FEN strings. These games will be stored in your browser's local storage, and you can always return to them later. Similarly, while analyzing any game, you are now able to make variations and experiment from any game position with real-time evaluation and branching.

Finally, we have made additional quality-of-life improvements across the analysis page, including: pagination to accommodate games when you have many of them, components to export your games/positions as PGN/FEN, clickable moves and tooltips across all analysis components to easily create variations and explore new positions, move quality indicators (blunders, surprisingly good moves, etc.) in the move lists, amongst many other mini-features. If you have any feedback on the analysis page, please let us know!

Opening Drill Page

opening-drill

We also introduce a brand new opening drill page, which provides a structured way to rehearse post-opening decision-making. This page is designed to promote deeper pattern recognition and decision-making practice in positions that arise frequently in practical play:

  1. You can configure a custom set of openings (with configurable length, difficulty, and drill count) you would like to practice
  2. Each drill begins in the post-opening position, allowing you to practice the transition into the middlegame against your preferred Maia model
  3. During drills, you can utilize all our standard analysis tools if you would like to experiment with the positions in real-time. This also includes all Maia/Stockfish insights: blunder meter, move map, moves by rating graph, etc.
  4. After each drill, you will receive feedback on critical decisions, what rating level you played like, Stockfish evaluations over time, and move-by-move quality assessment. (pictured above)
  5. Upon completing all your drills, you can review aggregate performance across all openings.

New Training Page

training

We overhauled the training page to provide a more structured and engaging way to practice chess skills. This page is designed to help you practice your chess skills in a more structured and engaging way:

  1. After completing/forfeiting a puzzle, you now have full access to the same analysis tools available on the game analysis page. This includes all Maia/Stockfish insights: blunder meter, move map, moves by rating graph, etc.
  2. You can also play out and explore the puzzle position after completing/forfeiting.

We have also improved puzzle history tracking, including rating changes and review of past puzzles.

User Experience Improvements

With the new platform, we have also introduced new interactive walkthroughs for each page, which are designed to help both new and returning users understand the full capabilities of the platform. Each major page now has a tutorial which will walk you through the different components and features of the page. If you would like to replay the walkthroughs, you can hit the ? button in the top left corner of each page.

Additionally, we have also added new features and made quality-of-life improvements across the platform:

  1. Improved challenge and rating history for bot-or-not (Turing Test) challenges and training puzzles
  2. Cleaner leaderboard which now displays top-rated users who have played within the last seven days
  3. Public profile pages for users which now display their elo and links to their external profiles (e.g., Lichess)
  4. Unified visual design across all pages with consistent layout, colors, and component structure.
  5. Improved support for players on mobile devices and smaller screens.
  6. Smoother transitions and animations to clarify user interactions.
  7. Pagination for long game histories, including sorting and export options (PGN/FEN).
  8. Improved homepage which now displays the latest news and research from the Maia Chess team.

Open Source and Community

The frontend casebase for the Maia Chess platform is entirely open-source. Developers, researchers, and contributors are welcome to view the codebase, suggest improvements, or integrate components into their own work. The full repository is available at:

GitHub: github.com/CSSLab/maia-platform-frontend

We also encourage users to participate in discussions, share feedback, and help shape future features. You can join the community through our public Discord:

Discord: discord.gg/hHb6gqFpxZ

Thank you to the community members and testers who have contributed to Maia Chess over the last year. We look forward to continued collaboration and feedback as we refine and expand the platform.


The Maia Chess Team

…lientAnalysisController and ClientGameControllerContext
…orage and implement arbitrary analysis exploration
… recommendations to current position component
@kevinjosethomas kevinjosethomas marked this pull request as ready for review July 11, 2025 14:49
@kevinjosethomas kevinjosethomas changed the title V1 Maia Platform v1 Launch Jul 11, 2025
- Deleted several unused image files related to the Maia beta release.
- Removed the platform beta blog post as it is no longer relevant.
- Changed "Meh Moves" to "OK Moves" across multiple components for consistency.
- Added data-testid attribute to the DownloadModelModal for improved testing.
- Implemented state management for download modal visibility in TourContext.
- Enhanced logic to prevent joyride display when the download modal is visible or just hidden.

This update aims to improve user experience and maintain consistent terminology throughout the application.
Postpone onboarding tutorial tours to after Maia model is downloaded
…ation and evaluation process

- Added nnueLoaded state to track NNUE model loading status.
- Implemented waitForReady method to ensure Stockfish is ready before sending commands.
- Updated ready getter to include nnueLoaded check.
- Improved error handling during NNUE model loading.

Resolves #22
Fix bugs prior to v1 Launch
…mproved styling

- Updated ErrorBoundary component to apply primary text color for better visibility.
- Refactored OpeningDrillSidebar to include drillSequence prop and improved drill navigation.
- Added functionality to navigate to specific drills and display their status (Completed, Current, Incomplete, Pending).
- Removed unnecessary console logs from useOpeningDrillController for cleaner code.
@kevinjosethomas
Copy link
Copy Markdown
Collaborator Author

Resolves #20, #22, and #23

@kevinjosethomas kevinjosethomas merged commit 3bbe868 into main Jul 11, 2025
6 checks passed
@kevinjosethomas kevinjosethomas deleted the v1 branch July 12, 2025 03:39
@kevinjosethomas kevinjosethomas restored the v1 branch July 12, 2025 03:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants