kc-ml2 / mas-tutorials

Multi-agent Reinforcement Learning Tutorial in Korean

Home Page:https://tutorials.kc-ml2.com/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


๐Ÿš€ MAS TUTORIAL ์†Œ๊ฐœ

MAS TUTORIAL์€ ๋จธ์‹ ๋Ÿฌ๋‹ ์—ฐ๊ตฌ์†Œ KC-ML2์—์„œ ์ œ์ž‘ํ•œ '๋ฉ€ํ‹ฐ์—์ด์ „ํŠธ ๊ฐ•ํ™”ํ•™์Šต(MARL)' ํŠœํ† ๋ฆฌ์–ผ์ž…๋‹ˆ๋‹ค. ๋ณธ ํŠœํ† ๋ฆฌ์–ผ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๋‚ด์šฉ์„ ๋‹ค๋ฃจ๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.

  • โœ๏ธ ๋ฐฐ์šฐ๊ธฐ : Multi-agent ๋ฌธ์ œ๋ฅผ ๊ฐ•ํ™”ํ•™์Šต(RL) ๊ด€์ ์—์„œ ๋ฐ”๋ผ๋ณด๋ฉฐ ๊ด€๋ จ ์ด๋ก ๋“ค๊ณผ ์•Œ๊ณ ๋ฆฌ์ฆ˜์„ ์†Œ๊ฐœํ•ฉ๋‹ˆ๋‹ค.
  • ๐ŸŽฎ ์‘์šฉํ•˜๊ธฐ : ๊ณ ์ „ ๊ฒŒ์ž„์ธ snake game์„ multi-player๋กœ ํ™•์žฅํ•˜์—ฌ RL๊ณผ MARL์˜ ๊ด€์ ์—์„œ ๋ถ„์„ํ•ฉ๋‹ˆ๋‹ค. ๋˜ํ•œ multi-agent snake game์ด ๊ตฌํ˜„๋œ ๊ฐ•ํ™”ํ•™์Šต ํ™˜๊ฒฝ MARLenv์˜ ์‚ฌ์šฉ๋ฒ•์„ ๋‹ค๋ฃจ๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ—’๏ธ MAS TUTORIAL ์ปจํŠธ๋ฆฌ๋ทฐ์…˜

ํŠœํ† ๋ฆฌ์–ผ์—์„œ ์˜คํƒ€ ๋˜๋Š” ํ˜ผ๋™๋˜๋Š” ๋‚ด์šฉ์ด๋‚˜ ๊ฐœ์„ ์„ ์œ„ํ•ด ์ถ”๊ฐ€ํ•˜์‹ค ๋‚ด์šฉ์ด ์žˆ๋‹ค๋ฉด issue๋ฅผ ์˜ฌ๋ฆฌ์‹œ๊ฑฐ๋‚˜ PR์„ ํ•ด์ฃผ์„ธ์š”! ๋”์šฑ ์œ ์ตํ•œ ํŠœํ† ๋ฆฌ์–ผ์„ ์œ„ํ•œ ์—ฌ๋Ÿฌ๋ถ„๋“ค์˜ ์ฐธ์—ฌ๋ฅผ ๊ธฐ๋‹ค๋ฆฝ๋‹ˆ๋‹ค : )

PULL REQUEST ๊ฐ€์ด๋“œ๋ผ์ธ

  • โœ… ์ƒˆ๋กœ์šด branch๋ฅผ ๋งŒ๋“ค์–ด ์ฃผ์„ธ์š”!
    • ํ˜„์žฌ ์‚ฌ์šฉ๋˜๋Š” ๊ธฐ๋ณธ branch (ex. main)๊ฐ€ ์•„๋‹Œ ๋ณ„๋„์˜ branch๋ฅผ ์ƒˆ๋กœ ๋งŒ๋“ค์–ด ์ž‘์—…ํ•ด ์ฃผ์„ธ์š”.
  • โœ… PR template์„ ์ž‘์„ฑํ•ด ์ฃผ์„ธ์š”!
    • PR template์— ์ ํžŒ PR์„ ํ•˜๊ฒŒ๋œ ์ด์œ ์™€ ์ˆ˜์ •์— ๋Œ€ํ•œ ์˜๊ฒฌ, ์ฃผ์š” ๋ณ€๊ฒฝ ์‚ฌํ•ญ์„ ๊ธฐ์ž…ํ•ด ์ฃผ์„ธ์š”.
  • โœ… ๋ฆฌ๋ทฐ ํ›„ ์ถ”๊ฐ€์ ์ธ ์ปค๋ฐ‹์ด ์ƒ๊ฒผ๋‹ค๋ฉด, Re-request review๋ฅผ ์ง„ํ–‰ํ•ด ์ฃผ์„ธ์š”!
    • ์ž์„ธํ•œ ๋ฐฉ๋ฒ•์€ ๋ฌธ์„œ๋ฅผ ์ฐธ๊ณ ํ•ด ์ฃผ์„ธ์š”.

Devcontainer ์‚ฌ์šฉ

  • Visual Studio Code์—์„œ Docker ์ปจํ…Œ์ด๋„ˆ๋ฅผ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์œผ๋กœ ์‚ฌ์šฉํ•˜์‹ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • Visaul Studio Code์—์„œ Remote-Container: Reopen in Container ์ปค๋งจ๋“œ๋ฅผ ์‹คํ–‰ํ•˜์‹œ๊ฑฐ๋‚˜, ํ•˜๋‹จ์˜ Reopen in Container ๋ฒ„ํŠผ์„ ๋ˆ„๋ฅด์‹  ํ›„ ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

๐Ÿ—๏ธ License

  • posts ํด๋” ์•ˆ์˜ ๋ฌธ์„œ์—๋Š” CC-BY-4.0 license๊ฐ€ ์ ์šฉ๋˜๊ณ  ์žˆ์œผ๋ฉฐ
  • ๊ทธ ์™ธ ํ•ด๋‹น repository์˜ ์ฝ”๋“œ์—๋Š” MIT license๊ฐ€ ์ ์šฉ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค.

About

Multi-agent Reinforcement Learning Tutorial in Korean

https://tutorials.kc-ml2.com/

License:Creative Commons Attribution 4.0 International


Languages

Language:Jupyter Notebook 94.3%Language:JavaScript 4.0%Language:SCSS 1.2%Language:Dockerfile 0.4%