Mryxania Digital Technical Lab

OPEN SOURCE

Step 01: Onboarding

첫 번째 기여를 위한
완벽한 출발

Mryxania Digital은 한국인 개발자가 글로벌 AI 오픈소스 생태계에 안착할 수 있도록 기술적 장벽을 허뭅니다. 이 가이드는 권한 설정부터 Pull Request 제출까지의 모든 과정을 표준화된 워크플로우로 안내합니다.

Pre-flight Checklist

글로벌 프로젝트 메인테이너들은 보안과 정합성을 가장 먼저 확인합니다. 작업을 시작하기 전, 아래 도구들이 최신 버전으로 설정되어 있는지 반드시 확인하십시오.

SSH Key 설정

보안 협업을 위해 GitHub 계정에 SSH 에이전트가 등록되어야 합니다. 공개 키가 누락되면 push 권한이 거부됩니다.

ssh -T [email protected]

Git v2.4x 이상 설치

최신 GitHub 기능 및 커밋 서명 기술을 활용하려면 최신 버전의 Git이 필수적입니다.

git --version

"성공적인 기여는 완벽한 환경 설정에서 시작됩니다. Mryxania Digital은 보안을 고려한 SSH 설정 표준 가이드를 권장합니다."

Visualized Workflow

기여 프로세스 시각화

1 # Fork한 저장소 복제하기
2 git clone https://github.com/USER/ai-project.git
3 # 작업 전용 브랜치 생성
4 git checkout -b feature/optimize-model
5 git status
On branch feature/optimize-model
nothing to commit, working tree clean
Terminal Demo

Branch Policy

모든 수정 사항은 main 브랜치가 아닌 고유 브랜치에서 수행해야 합니다. 이는 메인테이너가 여러분의 코드를 개별적으로 검토하고 승인하는 데 필수적입니다.

Commit Convention

Angular 또는 Conventional Commits 표준을 따르십시오. feat:, fix:, docs: 접두사를 사용하는 습관이 중요합니다.

당황하지 마세요.

오픈소스 기여는 기술적 숙련도보다 '커뮤니티와 동화되는 과정'이 더 중요합니다. 첫 시도시 흔히 발생하는 오류들에 대한 해결책을 마련했습니다.

PERMISSIONS

"Permission denied" 오류가 발생합니다.

주로 SSH 키가 제대로 등록되지 않았거나, 원본 저장소(Upstream)에 직접 push를 시도할 때 발생합니다. 자신의 Fork 저장소(Origin)에 push하고 있는지 확인하세요.

해결 방법 보기 →
SYNCHRONIZATION

Upstream과 싱크가 맞지 않습니다.

GitHub 웹 인터페이스의 'Sync fork' 버튼 또는 CLI의 fetch upstream 명령어를 통해 최신 상태를 유지해야 합니다. 충돌을 방지하는 가장 좋은 방법입니다.

동기화 가이드 →
FEEDBACK

PR이 거절되면 어떻게 하나요?

거절(Closed)은 실패가 아닌 학습의 과정입니다. 메인테이너의 리뷰 피드백을 꼼꼼히 읽고 수정하여 새로운 커밋을 제출하거나 토론에 참여하세요.

상담 요청하기 →
Final Call to Action

준비가 되셨나요?
첫 PR을 전송하세요.

글로벌 협업은 더 이상 먼 나라의 이야기가 아닙니다. Mryxania Digital의 가이드와 함께라면 대전에서도 세계 최고의 프로젝트에 이름을 새길 수 있습니다.

LOCATION: 대전광역시 서구 둔산중로 78 TEL: +82-42-482-8576
© 2026 Mryxania Digital. All Rights Reserved.