Skip to content

Commit 4f2589a

Browse files
committed
Open source JumpStar under MIT
1 parent 22ed671 commit 4f2589a

4 files changed

Lines changed: 100 additions & 8 deletions

File tree

CODE_OF_CONDUCT.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Code of Conduct
2+
3+
This project should be a welcoming place for people who like games, search,
4+
benchmarks, tooling, and learning in public.
5+
6+
Please:
7+
8+
- be kind and assume good intent when you can
9+
- make room for beginners and careful questions
10+
- criticize ideas, measurements, and code without attacking people
11+
- disclose uncertainty in benchmark claims
12+
- give credit for other people's work
13+
- avoid harassment, insults, threats, and discriminatory language
14+
15+
Maintainers may edit, hide, or remove comments and contributions that make the
16+
project hostile or unsafe. Repeated or severe violations may result in being
17+
blocked from participating.
18+
19+
If something feels off, please contact the maintainer privately through GitHub
20+
or open an issue if the concern is safe to discuss in public.

CONTRIBUTING.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
# Contributing
2+
3+
Thanks for taking an interest in JumpStar and CCERL. This project is meant to
4+
make Chinese Checkers engine work easier to inspect, reproduce, challenge, and
5+
improve.
6+
7+
Good contributions include:
8+
9+
- bug reports with reproduction steps
10+
- rules or referee fixes with small test cases
11+
- benchmark-runner improvements
12+
- external-engine adapters
13+
- documentation clarifications
14+
- careful benchmark results that include commands, versions, seeds, and logs
15+
16+
Before opening a pull request:
17+
18+
1. Build and test locally:
19+
20+
```sh
21+
cmake -S . -B build -DCCZERO_USE_ACCELERATE=OFF
22+
cmake --build build --parallel
23+
ctest --test-dir build --output-on-failure
24+
```
25+
26+
2. Keep changes focused. A rules fix, benchmark-data update, and UI polish pass
27+
should usually be separate pull requests.
28+
29+
3. Be explicit about benchmark claims. Include the ruleset, position suite,
30+
simulation/search settings, commit hash, and whether results are official,
31+
provisional, or self-reported.
32+
33+
4. Credit upstream projects and prior work. If you adapt an external engine,
34+
document the source repository, license, build settings, and rule differences.
35+
36+
## Benchmark Etiquette
37+
38+
CCERL is intended to make disagreement productive. Stronger engines are welcome.
39+
So are bug reports that lower JumpStar's rating, expose a rule issue, or show a
40+
better methodology. Please keep the discussion centered on reproducible evidence.
41+
42+
## Model Files
43+
44+
The repository records model labels and checksums, but does not store `.ccpv`
45+
model weights in Git history. If you add or update model artifacts, prefer
46+
GitHub Release assets or another explicit download channel, and document hashes.
47+

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Joe Philleo
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
# JumpStar Chinese Checkers Engine
22

33
This is the public engine and benchmark repository for JumpStar, a
4-
self-play-trained Chinese Checkers AI. As of the public launch on **2026-05-23**,
5-
`JumpStar_60` is, to the best of this project's public evidence, the strongest
6-
openly documented Chinese Checkers AI engine under the `CCERL-2P10-v2`
7-
benchmark. That claim is benchmark-scoped: stronger private engines may exist,
8-
and CCERL is designed so public challengers can test the result.
4+
self-play-trained Chinese Checkers AI created by **Joe Philleo**. As of the
5+
public launch on **2026-05-23**, `JumpStar_60` is, to the best of this project's
6+
public evidence, the strongest openly documented Chinese Checkers AI engine
7+
under the `CCERL-2P10-v2` benchmark. That claim is benchmark-scoped: stronger
8+
private engines may exist, and CCERL is designed so public challengers can test
9+
the result.
910

1011
This repository intentionally contains only the public research surface:
1112

@@ -14,6 +15,7 @@ This repository intentionally contains only the public research surface:
1415
- the CCERL benchmark rules, protocol, positions, and baseline definitions
1516
- public leaderboard and direct-match evidence
1617
- a small benchmark runner/tool subset
18+
- a lightweight static replay viewer
1719

1820
It does not contain the hosted website, Vercel deployment code, private training
1921
automation, or internal experiment workspaces.
@@ -98,6 +100,8 @@ Release assets and restored to the paths documented in
98100

99101
## License
100102

101-
No open-source license has been selected yet. Until a license is added, this
102-
source is public for inspection and reproducibility but is not broadly licensed
103-
for reuse or redistribution.
103+
This repository is open source under the [MIT License](LICENSE).
104+
105+
Model checkpoints are not stored in Git history. If model files are published as
106+
release assets later, their download page should state whether the same license
107+
or separate model-artifact terms apply.

0 commit comments

Comments
 (0)