Repolode
제출하기
volcengine

volcengine/OpenViking

AI 에이전트의 지식, 메모리, 스킬을 탐색하고 편집할 수 있는 viking:// 파일시스템 하나에 저장하는 오픈소스 컨텍스트 데이터베이스입니다.

GitHub에서 보기웹사이트
스타
41,627
포크
3,399
열린 이슈
1,030
마지막 커밋
20시간 전

어떤 프로젝트인가요?

OpenViking은 AI 에이전트를 위한 컨텍스트 데이터베이스입니다. 에이전트의 메모리를 불투명한 임베딩으로 저장하는 대신, viking:// 스킴 아래 가상 파일시스템으로 지식, 메모리, 스킬을 정리합니다. 따라서 에이전트는 ls, tree, read, write, grep 같은 명령으로 탐색할 수 있고, 사람도 디렉터리를 열어 에이전트가 알고 있는 내용을 확인하거나 편집할 수 있습니다.

각 디렉터리에는 자동 생성된 L0 요약과 L1 개요가 포함되어, 에이전트가 전체 L2 콘텐츠를 불러오기 전에 짧은 요약만으로 관련성을 판단할 수 있습니다. 시맨틱 검색 범위는 프로젝트나 메모리 하위 트리로 한정할 수 있습니다. 커밋된 세션은 보관되고, 세션에서 추출한 메모리는 Markdown 파일로 저장됩니다.

이 프로젝트는 서버, ov라는 CLI, Python·Go·TypeScript SDK, HTTP API를 제공하며, Claude Code, Codex, Cursor, OpenCode 같은 코딩 에이전트와 LangChain 같은 프레임워크를 연동할 수 있습니다. 라이선스는 AGPLv3이며, 직접 호스팅하거나 Volcengine 호스팅 서비스를 이용할 수 있습니다.

핵심 기능

  • 01viking:// URI를 사용하는 파일시스템에서 에이전트의 지식, 메모리, 스킬을 탐색합니다.
  • 02에이전트가 내용을 읽기 전에 훑어볼 수 있도록 디렉터리별 L0 요약과 L1 개요를 생성합니다.
  • 03평면적인 벡터 풀 대신 디렉터리 하위 트리로 시맨틱 검색 범위를 한정합니다.
  • 04세션을 보관하고 추출한 메모리를 편집 가능한 Markdown 파일로 저장합니다.
  • 05CLI, Python·Go·TypeScript SDK, HTTP API를 제공합니다.

활용 사례

  • 세션이 바뀌어도 유지되는 사용자 선호도와 프로젝트 맥락을 코딩 에이전트에 제공하기.
  • 디렉터리 단위 검색으로 프로젝트 문서와 저장소를 대상으로 검색 시스템 구축하기.
  • 팀에서 AI 에이전트가 기억한 내용을 확인하고 수정할 수 있게 하기.
  • LangChain 또는 MCP 기반 에이전트를 공유 컨텍스트 저장소에 연결하기.

빠른 시작

  1. 1

    uv로 OpenViking을 설치하고 설정 마법사를 실행해 모델을 구성합니다

    uv tool install openviking --upgrade && openviking-server init
  2. 2

    서버를 시작하고 터미널을 열어 둡니다(서버는 포그라운드에서 실행됩니다)

  3. 3

    서버가 실행 중일 때 ov CLI로 상태를 확인합니다

    ov status

사용 전 알아둘 점

  • AGPL-3.0 카피레프트 라이선스가 적용됩니다. 네트워크 서비스로 제공하는 경우 수정한 소스 코드를 공유해야 합니다.
  • 셀프 호스팅에는 임베딩 모델과 VLM을 제공하는 모델 제공업체가 필요합니다. API 키를 사용하거나 Ollama와 같은 로컬 모델을 사용해야 합니다.
  • 에이전트 메모리 플러그인 설치 프로그램은 macOS 또는 Linux가 필요합니다. Windows 사용자는 데스크톱 앱을 사용해야 합니다.

포함된 컬렉션

AI 에이전트 장기 기억

토픽

#agent-memory#context-database#rag#vector-search#llm-agents#knowledge-base#filesystem#agent-context#agent-plugins#agentic-rag

자주 묻는 질문

OpenViking은(는) 무엇인가요?
AI 에이전트의 지식, 메모리, 스킬을 탐색하고 편집할 수 있는 viking:// 파일시스템 하나에 저장하는 오픈소스 컨텍스트 데이터베이스입니다. OpenViking은 AI 에이전트를 위한 컨텍스트 데이터베이스입니다. 에이전트의 메모리를 불투명한 임베딩으로 저장하는 대신, viking:// 스킴 아래 가상 파일시스템으로 지식, 메모리, 스킬을 정리합니다. 따라서 에이전트는 ls, tree, read, write, grep 같은 명령으로 탐색할 수 있고, 사람도 디렉터리를 열어 에이전트가 알고 있는 내용을 확인하거나 편집할 수 있습니다.
OpenViking은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
OpenViking은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
OpenViking은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. OpenViking의 마지막 커밋은 2026년 11월 5일입니다.
OpenViking은(는) 어디에 사용할 수 있나요?
세션이 바뀌어도 유지되는 사용자 선호도와 프로젝트 맥락을 코딩 에이전트에 제공하기. 디렉터리 단위 검색으로 프로젝트 문서와 저장소를 대상으로 검색 시스템 구축하기. 팀에서 AI 에이전트가 기억한 내용을 확인하고 수정할 수 있게 하기. LangChain 또는 MCP 기반 에이전트를 공유 컨텍스트 저장소에 연결하기.
OpenViking는 어떻게 설치하나요?
uv로 OpenViking을 설치하고 설정 마법사를 실행해 모델을 구성합니다: uv tool install openviking --upgrade && openviking-server init 서버를 시작하고 터미널을 열어 둡니다(서버는 포그라운드에서 실행됩니다) 서버가 실행 중일 때 ov CLI로 상태를 확인합니다: ov status
OpenViking은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/volcengine/OpenViking

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트