Ling Stack

<div align="center"> <img src="https://raw.githubusercontent.com/ling-stack-org/ling-stack/HEAD/apps/web/public/icons/ling-mark.svg" alt="Ling Stack" width="88" height="88" /> <h1>Ling Stack</h1> <p><strong>AI 팀원을 하나의 로컬 프로젝트 작업 공간으로 가져오세요.</strong></p> <p>사용할 모델을 선택하고, 대화 내용, 도구 승인 및 결과를 한곳에 보관하세요.</p> <p> English · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja-JP.md">日本語</a> · <a href="README.ko-KR.md">한국어</a> · <a href="README.de-DE.md">Deutsch</a> · <a href="README.fr-FR.md">Français</a> · <a href="README.es-ES.md">Español</a> · <a href="README.pt-BR.md">Português (Brasil)</a> </p> <p> <img alt="Source alpha" src="https://img.shields.io/badge/Status-source_alpha-5964a0.svg" /> <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-08765d.svg" /></a> <img alt="Node.js 22.22.1+" src="https://img.shields.io/badge/Node.js-22.22.1%2B-3c873a.svg" /> <img alt="pnpm 10" src="https://img.shields.io/badge/pnpm-10-f69220.svg" /> </p> <p> <a href="docs/community/first-project-review.md">프로젝트 검토 시도하기</a> · <a href="docs/getting-started.md">시작하기</a> · <a href="docs/troubleshooting.md">문제 해결</a> · <a href="docs/architecture.md">아키텍처</a> · <a href="CONTRIBUTING.md">기여하기</a> · <a href="CHANGELOG.md">변경 로그</a> </p> </div>

[!NOTE]
소스 기반 알파 버전. Web UI, 로컬 데몬 및 CLI를 소스로 시작하세요.
데스크톱 개발은 별도로 제공되며, 안정적인 서명된 설치 파일이나 지원되는 프로덕션 릴리스는 아직 이용할 수 없습니다.

하나의 공유 작업으로 시작하기

여러 모델이 관련된 작업을 할 때, 해당 작업, 응답, 도구 요청 및 결과가 분리된 창에 놓일 수 있습니다. Ling Stack은 이러한 작업을 프로젝트 채널로 가져옵니다: 팀원들에게 모델과 도구 바인딩을 제공하고, 그들의 활동을 검토하며, 결과를 대화 내용과 함께 유지하세요.

두 명의 팀원과 공개 샘플 브리프를 사용하여 제한적인 프로젝트 문서 검토를 시도해 보세요. 토론으로 시작하고, 나중에 작업에서 도구나 권한이 필요할 때 추가하세요. 사용자의 자체 제공업체 구성 및 API 키가 필요하며, 제공업체 요금이 부과됩니다.

Ling Stack English homepage in a fresh workspace

비밀 정보가 아닌 데모 모델을 선택하여 새로 만든 로컬 워크스페이스의 영어 인터페이스입니다. 외부 모델 요청은 이루어지지 않았습니다. 이 스냅샷은 완료된 작업이 아니라 워크스페이스 레이아웃을 보여줍니다. 위의 검토 가이드를 따라 자신만의 첫 협업을 시도해 보세요.

누가 사용하기 좋은가요?

Ling Stack은 여러 AI 모델이나 팀원들과 함께 일하며 자신의 작업을 한곳에 보관하고 싶은 개발자 및 사람들을 위한 것입니다. 이는 공유된 Model Workbench를 통해 OpenAI, Anthropic, Volcengine Ark, DeepSeek 호환 엔드포인트, MiniMax, GLM, 그리고 OpenAI 호환 릴레이를 연결합니다.

워크스페이스 상태, 대화 기록, 실행 증거는 로컬에 저장됩니다. 요청과 그 컨텍스트는 사용자가 선택한 모델 또는 도구 제공업체로 전송됩니다. 이 인터페이스는 55개 언어 및 지역 옵션을 제공하며, 인터페이스 언어와 AI 응답 언어를 별도로 구성할 수 있습니다. README 번역은 위에 연결된 여덟 개 언어를 다루며, 모든 인터페이스 로케일을 다루지는 않습니다. 다른 문서는 여전히 영어 또는 중국어로 되어 있을 수 있습니다.

사용 방법 세 가지

시나리오	수행하는 작업	함께 유지되는 것
모델에게 질문하기	채팅 모델을 구성하고 문서, 아이디어 또는 프로젝트에 대한 대화를 시작합니다	메시지, 모델 선택, 첨부 파일 및 결과
...
간단한 대화로 시작한 다음, 작업이 필요할 때 팀원이나 도구를 추가하세요. 스킬은 지침을 제공하며, 도구 접근 및 권한은 명시적으로 유지됩니다. 코딩 에이전트 작업은 Pi 런타임 어댑터를 사용하며, 사용 가능한 실행 도구는 플랫폼 설정과 워크스페이스 정책에 따라 달라집니다.

소스에서 빠르게 시작하기

요구 사항: Git, Node.js 22.22.1 이상, 그리고 pnpm 10을 사용하는 Corepack.
저장소는 pnpm 10.0.0으로 고정되어 있으며, Node 22.22.1이 CI 기준선입니다.

1. 로컬 웹 스택 설치 및 빌드

git clone https://github.com/ling-stack-org/ling-stack.git
cd ling-stack
corepack enable
...

필터링된 빌드는 CLI, 데몬(daemon), 웹 앱(Web app) 및 해당 워크스페이스 종속성을 포함합니다.
데스크톱 및 모바일 빌드는 별도의 설정 요구 사항을 가집니다.

2. 데몬 시작

이 명령어를 첫 번째 터미널에서, 저장소 루트 디렉터리에서 실행하여 계속 유지하세요:

corepack pnpm ling daemon start --foreground

기본 데몬 주소는 http://127.0.0.1:17891입니다. 루프백(loopback)으로 유지하세요.

3. 웹 UI 열기

두 번째 터미널에서, 동일한 저장소 루트 디렉터리에서:

corepack pnpm ling ui --foreground --open

브라우저가 자동으로 열리지 않으면 http://127.0.0.1:5173을 여세요. 다른 터미널에서, curl http://127.0.0.1:17891/health는 `

Surface 또는 통합	현재 범위
Web, daemon 및 CLI	소스 알파 버전; 기본 시작 경로...
...
Platform 실행, 접근성, 서명(signing), 설치 프로그램 승인(installer acceptance)은 선택된 네이티브 기능에 대해 여전히 미개방 상태입니다. 구현 상태 인덱스는 무엇이 구현되었고 무엇이 아직 승인이 필요한지 기록합니다. 소스 빌드 또는 집중 테스트 결과가 설치 프로그램 준비 상태를 확립하지는 않습니다.

질문 및 재현 가능한 버그의 경우, 지원을 읽고 GitHub 이슈 양식을 사용하세요. 유지보수는 최선의 노력(best effort)입니다. 취약점은 보안을 통해 보고해 주세요.

데스크톱 개발

데스크톱은 추가 요구 사항이 있습니다: macOS의 Swift 및 codesign을 사용하는 Xcode Command Line Tools, 또는 Office 드라이버를 위한 Windows용 .NET 8 SDK입니다. 현재 데스크톱 배포 대상은 macOS arm64와 Windows x64입니다. Electron 역시 플랫폼 바이너리가 필요합니다. 데스크톱 문제 해결을 참조하세요.

corepack pnpm --filter @ling-stack/desktop dev

플랫폼 도구, 빌드 명령어 및 수동 확인은 Mac 및 Windows 개발 패키지 가이드를 따르세요. 배포용으로 패키징하기 전에 데스크톱 릴리스 및 승인을 읽어보세요. 공개 소스 출판과 서명된 바이너리 릴리스는 별도의 단계입니다.

데이터 및 권한

기본 작업 공간 상태(workspace state)는 .ling-stack/ 아래에 있으며, 여기에는 ling-stack.sqlite, sessions/, artifacts/, 및 logs/가 포함됩니다. Model Workbench에서 입력된 Provider 키는 로컬 작업 공간 저장소에 저장됩니다. 환경 및 지원되는 keychain 참조도 사용할 수 있습니다. 구성 및 데이터를 참고하세요.

키, 데이터베이스, 세션 로그 및 비공개 출력물은 Git과 공개 보고서에 포함하지 마세요.
작업 공간 권한(Workspace permissions)은 파일 접근, 셸 명령어, 외부 변경 사항, 유료 생성을 관리합니다. 승인 요청을 수락하기 전에 검토하세요. 스토리지 마이그레이션에는 CLI 스토리지 흐름을 사용하세요.

탐색 또는 기여

이 워크플로우가 유용하다면, 저장소에 별표를 눌러 진행 상황을 팔로우하세요. Issue 양식을 통해 어떤 것을 시도했는지, 첫 번째 작업이 어디서 막혔는지, 그리고 결과가 도움이 되었는지를 알려주세요.

README 번역 가이드라인: 언어 버전을 일치시키는 데 도움을 줍니다.
첫 프로젝트 검토: 소규모 협업 시도입니다.
커뮤니티 출시 키트: 소개 초안 및 초기 사용자 피드백 계획입니다.

웹 앱(apps/web), 데스크톱 셸(apps/desktop), 그리고 CLI(packages/cli)는 데몬(packages/daemon)을 공유합니다. 핵심 도메인 로직, 계약(contracts), 제공자 어댑터(provider adapters), 및 러너 통합(runner integrations)은 packages/ 아래에 있습니다.

기여하기: 설정, 집중 검사, 그리고 풀 리퀘스트 기대 사항입니다.
아키텍처 및 데몬 API: 시스템 경계입니다.
디자인 인덱스 및 구현 상태: 유지 관리되는 계약과 수용 게이트입니다.
제공자 어댑터 및 Pi 통합: 모델 및 런타임 통합입니다.
릴리스 정책, 변경 로그, 및 제3자 고지: 출판 및 라이선싱에 관한 내용입니다.

Ling Stack은 MIT License 하에서 사용할 수 있습니다. 커뮤니티 참여는 Code of Conduct를 따릅니다.