MemOS

(★ 10,877)

LLM 및 AI Agent를 위한 자기 진화형 메모리 OS: 초지속성 메모리, 하이브리드 검색, 교차 태스크 스킬 재사용을 지원하며, 35.24%의 토큰 절감 효과와 DeepSeek Harness를 지원합니다.

파일 탐색기

  • .gitignore
  • .pre-commit-config.yaml
  • AGENTS.md
  • CLAUDE.md
  • CONTRIBUTING.md
  • Dockerfile
  • LICENSE
  • Makefile
  • poetry.lock
  • pyproject.toml
  • README.md
  • README_ZH.md
  • uv.lock

# 설치 가이드

docker / python
사전 준비물

설치 및 실행 절차

git clone https://github.com/MemTensor/MemOS.git

프로젝트 소스코드를 로컬에 복제합니다.

cp docker/.env.example .env

환경 변수 설정 파일을 복사하고 API 키를 설정합니다.

docker compose up

Docker Compose를 사용하여 MemOS API 및 데이터베이스 서비스를 실행합니다.

uvicorn memos.api.server_api:app --host 0.0.0.0 --port 8000 --workers 1

Docker를 사용하지 않는 경우 uvicorn을 통해 API 서버를 직접 실행합니다.

핵심 명령어

docker compose up

MemOS API, Neo4j, Qdrant를 포함한 전체 도커 서비스를 백그라운드 또는 포그라운드로 실행합니다.

uvicorn memos.api.server_api:app --host 0.0.0.0 --port 8000 --workers 1

로컬 환경에서 MemOS REST API 서버를 직접 구동합니다.

docker/.env.example 파일을 .env로 복사한 뒤 필요한 LLM 프로바이더 및 임베딩 API 키를 반드시 입력해야 합니다.

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

릴리즈 타임라인

활발히 관리 중

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

docker compose up

설명 보기 ▼

Start and run Docker services defined in a Compose file.

docker compose up

Start all services defined in the docker-compose file:

docker compose up {{[-d|--detach]}}

Start services in the background (detached mode):

docker compose up --build

Start services and rebuild images before starting:

🔍

git clone

설명 보기 ▼

Clone an existing repository.

git clone {{remote_repository_location}} {{path/to/directory}}

Clone an existing repository into a new directory (the default directory is the repository name):

git clone --recursive {{remote_repository_location}}

Clone an existing repository and its submodules:

git clone {{[-n|--no-checkout]}} {{remote_repository_location}}

Clone only the `.git` directory of an existing repository:

🔍

npx

설명 보기 ▼

이 명령은 `npm exec`의 별칭입니다.

tldr npm exec

자세한 내용은 원본 명령을 참고하세요:

🔍

openclaw gateway

설명 보기 ▼

Start the OpenClaw gateway server (control plane).

openclaw gateway --allow-unconfigured

Start the gateway on the default port (18789):

openclaw gateway --allow-unconfigured --port {{18789}}

Start the gateway on a specific port:

openclaw gateway --allow-unconfigured --verbose

Start the gateway with verbose logging:

🔍

openclaw

설명 보기 ▼

개인 기기에서 실행되는 개인 AI 어시스턴트.
`onboard`, `agent`, `doctor`와 같은 일부 하위 명령어는 별도의 사용법 문서를 가짐.
관련 항목: `zeroclaw`.
더 많은 정보: <https://docs.openclaw.ai/cli>.

openclaw onboard --install-daemon

게이트웨이 및 채널 설정을 위한 온보딩 실행:

openclaw gateway --allow-unconfigured --port {{18789}} --verbose

게이트웨이 서버 시작:

openclaw message send {{[-t|--target]}} {{+1234567890}} {{[-m|--message]}} "{{Hello}}"

연락처에 메시지 전송:

🔍

uvicorn

설명 보기 ▼

비동기 프로젝트를 위한 Python ASGI HTTP 서버.
더 많은 정보: <https://www.uvicorn.org/settings/>.

uvicorn {{import.path:app_object}}

Python 웹 앱 실행:

uvicorn --host {{localhost}} --port {{8080}} {{import.path:app_object}}

localhost에서 포트 8080으로 수신 대기:

uvicorn --reload {{import.path:app_object}}

라이브 리로드 활성화:

# 프로젝트 배지

// repository documentation