adaptive-memory-engine 0.1.6__py3-none-any.whl

adaptive_memory_engine-0.1.6.dist-info/METADATA

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: adaptive-memory-engine
+Version: 0.1.6
+Summary: Local-first CLI memory engine that builds Bronze/Silver/Gold RAG memory from local documents.
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,local-first,mcp,memory,ollama,rag
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Indexing
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: lightrag
+Requires-Dist: lightrag-hku; extra == 'lightrag'
+Requires-Dist: ollama; extra == 'lightrag'
+Description-Content-Type: text/markdown
+
+# Adaptive Memory Engine Core
+
+[English](README.en.md)
+
+Adaptive Memory Engine Core는 내 로컬 문서를 읽어 Bronze/Silver/Gold 메모리로 만들고,
+Codex나 Claude Code가 그 메모리를 보고 답할 수 있게 해주는 local-first 메모리 엔진입니다.
+
+사용자가 매번 긴 명령어를 치는 방식보다, **Codex/Claude Code에 AME를 연결하고 자연어로 맡기는 방식**을 우선합니다.
+
+현재는 alpha 단계이며 PyPI로 배포 중입니다. 현재 버전은 `0.1.6`입니다.
+
+## 1. 설치
+
+macOS/Linux:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/kimdol1045-hash/adaptive-memory-engine/main/install.sh | bash
+```
+
+Windows PowerShell:
+
+```powershell
+irm https://raw.githubusercontent.com/kimdol1045-hash/adaptive-memory-engine/main/install.ps1 | iex
+```
+
+설치 스크립트는 `~/.ame`에 AME를 설치하고 `ame` 명령을 PATH에 추가합니다. macOS/Linux에서는 설치 직후 스크립트가 출력하는 `source ...` 명령을 현재 터미널에 한 번 실행하면 됩니다.
+
+```bash
+source ~/.zshrc
+```
+
+직접 설치하고 싶다면 PyPI에서 설치할 수 있습니다.
+
+```bash
+python -m pip install adaptive-memory-engine
+```
+
+커스텀 MCP로만 쓸 때도 AME 실행 파일은 로컬에 있어야 합니다. PyPI/GitHub는 설치 파일을 배포하는 곳이고, MCP 클라이언트는 로컬에서 `ame mcp stdio` 프로세스를 실행합니다.
+
+## 2. Codex 또는 Claude Code에 연결
+
+Codex용 MCP 설정을 출력해서 Codex의 커스텀 MCP 설정에 붙입니다.
+
+```bash
+ame connect --client codex
+```
+
+Claude Code를 쓴다면 다음 명령을 사용합니다.
+
+```bash
+ame connect --client claude
+```
+
+출력된 JSON의 기본 `command`는 절대경로가 아니라 `ame`입니다.
+
+```json
+{
+  "command": "ame",
+  "args": ["mcp", "stdio"]
+}
+```
+
+기본 설정에는 실행 파일 절대경로를 넣지 않습니다. MCP 클라이언트가 실행될 때마다 가상환경을 직접 활성화할 필요도 없습니다.
+
+이때 아직 문서 메모리를 만들지 않았어도 괜찮습니다. `ame connect --client ...`는 bootstrap MCP 설정을 출력하므로, Codex/Claude Code가 사양 진단부터 메모리 구축까지 진행할 수 있습니다.
+
+## 3. 자연어로 요청
+
+이제 Codex나 Claude Code에 이렇게 말하면 됩니다.
+
+```text
+내 컴퓨터 사양을 진단하고 AME에 맞는 로컬 모델을 추천해줘.
+다운로드가 필요하면 어떤 모델을 받을지 먼저 알려줘.
+내가 승인하면 모델을 설치해줘.
+그 다음 /Users/me/Documents/planning 폴더를 my-docs라는 이름으로 메모리화해줘.
+구축이 끝나면 그 메모리를 기준으로 질문에 답해줘.
+```
+
+이후에는 평소처럼 질문하면 됩니다.
+
+```text
+이 문서들에서 현재 유효한 결정은 뭐야?
+왜 이런 구조를 선택했는지 근거를 찾아줘.
+지난 결정 중 지금은 superseded 된 게 있어?
+```
+
+## AME가 제공하는 MCP 도구
+
+Codex/Claude Code는 AME MCP를 통해 다음 도구를 사용할 수 있습니다.
+
+- `ame_doctor`: 컴퓨터 사양과 로컬 모델 상태 진단
+- `ame_setup`: 추천 모델 다운로드 계획 또는 실행
+- `ame_load`: 문서 폴더를 Bronze/Silver/Gold 메모리로 구축
+- `ame_corpora`: 만들어진 corpus 목록 확인
+- `memory_search`, `memory_query`: 구축된 메모리 기반 질문
+- `memory_graph`, `memory_decisions`, `memory_timeline`, `memory_why`: 구조화된 메모리 조회
+
+모델 다운로드는 시간과 디스크를 사용합니다. Codex/Claude Code가 먼저 다운로드 계획을 보여준 뒤, 사용자가 승인하면 실행하는 흐름을 권장합니다.
+
+## CLI로 직접 쓰고 싶을 때
+
+에이전트 없이 직접 사용할 수도 있습니다.
+
+```bash
+ame doctor
+ame setup
+ame setup --execute
+ame load my-docs ./path/to/markdown-docs
+ame chat my-docs
+```
+
+`ame chat`에 들어가면 매번 명령어를 치지 않고 질문만 입력할 수 있습니다.
+
+```text
+ame> 현재 유효한 결정은 뭐야?
+ame> 왜 LightRAG를 선택했어?
+ame> /exit
+```
+
+## 설치 문제 해결
+
+가상환경은 패키지를 격리해서 설치하기 위한 용도입니다.
+MCP 설정을 한 번 추가한 뒤에는 Codex/Claude Code가 `ame` 명령을 직접 실행합니다.
+
+터미널에서 `ame` 명령이 안 보이면 PATH를 다시 적용합니다.
+
+```bash
+source ~/.zshrc
+ame --help
+ame connect --client codex
+```
+
+MCP 클라이언트가 `ame`를 찾지 못한다면 PATH를 JSON에 같이 넣을 수 있습니다.
+
+```bash
+ame connect --client codex --include-path-env
+```
+
+그래도 안 되면 예전 방식처럼 실행 파일 절대경로를 넣을 수 있습니다.
+
+```bash
+ame connect --client codex --absolute-command
+```
+
+예전 문서의 `memory` 명령과 충돌할 수 있어서, 새 버전에서는 `ame` 명령을 기본으로 사용합니다.
+`memory`는 호환용 alias로 남아 있지만 가능하면 `ame`를 사용하세요.
+
+## MCP 모드
+
+AME는 두 가지 MCP 모드를 제공합니다.
+
+아직 corpus가 없고 Codex/Claude Code가 설정부터 진행해야 한다면 bootstrap MCP를 사용합니다.
+
+```bash
+ame mcp stdio
+```
+
+이미 만들어진 특정 corpus만 보게 하려면 corpus-bound MCP를 사용합니다.
+
+```bash
+ame mcp stdio my-docs
+```
+
+대부분의 사용자는 직접 `ame mcp stdio`를 실행하지 않고, `ame connect --client codex` 또는 `ame connect --client claude`로 출력된 설정을 클라이언트에 넣으면 됩니다.
+
+## Bronze/Silver/Gold 구조
+
+- Bronze: 원본 문서를 보존합니다.
+- Silver: 엔티티, 관계, 결정, 근거, 제약을 구조화합니다.
+- Gold: 그래프, 타임라인, supersession, 검증 정보를 구성합니다.
+
+`ame load`의 기본 모드는 로컬 LLM을 사용하는 Bronze/Silver/Gold 구축입니다.
+테스트나 fallback이 필요할 때만 deterministic 모드를 사용합니다.
+
+```bash
+ame load my-docs ./path/to/docs --mode deterministic
+```
+
+## SDK
+
+```python
+from ame.sdk import Corpus
+from memory import Corpus
+```
+
+## 테스트
+
+```bash
+pytest
+```
+
+## 참고 문서
+
+- `docs/product_user_flow.md`: 의도한 CLI 제품 흐름
+- `docs/release_distribution_plan.md`: 외부 배포 계획
+- `docs/pypi_release_checklist.md`: PyPI/TestPyPI 배포 체크리스트
+- `docs/standalone_distribution.md`: standalone 패키지 분리 전략

adaptive_memory_engine-0.1.6.dist-info/RECORD

@@ -0,0 +1,72 @@
+ame/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+ame/context_budget.py,sha256=n1rPiSsLkol1mw-qnz0IGJPFgs9JB-18aSGb2EVj7bQ,3535
+ame/pipeline.py,sha256=oV68YYAUqtDNhXKJDoJLO38WKuCh57KMKc8vcVoTDPM,6356
+ame/sdk.py,sha256=eiBmbPeihHpdpRYf0N8rYxKyVdHQyOpfuPEPnv9vKj8,1819
+ame/security.py,sha256=rjyVwR_PlHjB28adedKDgU6lMf7u_3EzuXPne9bhqY8,4607
+ame/writeback.py,sha256=avj4-LItIwwoajF5s1nnW9kqHn6GOrTjwAYdycvzDmg,7630
+ame/agent/__init__.py,sha256=IHzSRSIx8LYPBKTrE4oZO3ORIknT6UrhpcLDcDdJFCA,31
+ame/agent/mcp.py,sha256=cW0ljwaAYTGj-y25ExeIniglP4kUHQpr8Cs-G8yRHMQ,19614
+ame/agent/memory_api.py,sha256=6Uf4q0DaOTmXytkmWNPoI8iJ8paB2-WvmlxzTrnG0AM,5803
+ame/agent/results.py,sha256=28B5nPRmEhkRuU0uJ4iUUjqzZXKDNN_IU8vFkswEtSk,702
+ame/bronze/schema.py,sha256=JCtpumlb8F6-CrzwWRhMhRqAjVUL-JpaOSLtR4sBTok,427
+ame/bronze/store.py,sha256=ykSXLsn3gw1V1rIrLrjef_UpnHDgybUDNv87bxd3Atw,1462
+ame/cli/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+ame/cli/main.py,sha256=lPJbdsWUmlYgdgSdl_5ikeaGjD520lR_E2T7l-e4wsc,35862
+ame/connectors/base.py,sha256=66U9PZyQrhEEeH0HP3XnP8br1C0F9W-JYKIR6TOsq2U,733
+ame/connectors/contract.py,sha256=78PAITxviryK42MPjc9k-o_6rjVGgQzaPJRwWuvxMmc,6807
+ame/connectors/github.py,sha256=VTds3e0OLF_OiJpQ_V-TI59x8xfY5LPh85W8X3jeZqo,2656
+ame/connectors/google.py,sha256=zheO0-JXvxEXxGKKxDbPG6Kvbz5eKGLwPj2IZNYX7Zg,19204
+ame/connectors/google_oauth.py,sha256=ToXLAG0RNFxozX09CXScsLqaiczyhE0DTKuUNv5hIL4,5523
+ame/connectors/jira.py,sha256=84wket1d_Rr05HUJiMKjpZQ---PGhyln4UB0ohmBWg8,2629
+ame/connectors/json_helpers.py,sha256=LLO2UaJxqEPYfWMoa4U7_2qF7_v-sfjSwkJwQUb5BAg,964
+ame/connectors/markdown.py,sha256=J-vKcWA4JDIJslBFH1H2R2vEB2AtXMieZrzWmkkX2jY,4948
+ame/connectors/notion.py,sha256=kbl4jq1nCZ_AWM367qg-6svyP9o-7sgi1fDIh0V929s,2221
+ame/connectors/oauth_callback.py,sha256=zg3S4xv1ok7YwcFqnF38gJ0OJf3XLDPIUtMmBzswolY,3538
+ame/connectors/oauth_provider.py,sha256=peYMJFPoEN1hXVf6oFochtADwBU8bd-izROfWM9m7LE,9238
+ame/connectors/obsidian.py,sha256=ppnNYPSEFStRdCLoGAx-lEZuk6MP9jcFEjF7THqBmlI,595
+ame/connectors/router.py,sha256=OEY_tPwOOc6K4CZ12DUZDc7kx2e64d1KzHJ9HwaSPKM,6802
+ame/connectors/slack.py,sha256=ZabfrHPrDTPKa5UV-GsvSdTbOAPcJ_21EWWFAMT54SQ,2588
+ame/connectors/slack_oauth.py,sha256=FPdiT3S58Cf4Qkxv-E02ryxysaxtr8TdaqgUL9CspOo,15477
+ame/connectors/sync_history.py,sha256=tBpzGIgdQaZDzp-WSF-feAcu6HmqEHM1GsbcDMuKf0g,2470
+ame/core/config.py,sha256=vGUmnCke58DbtgosSQZ4tjROC4_JONnUrKcNF5rmGx4,2378
+ame/core/corpus.py,sha256=-k49N4aCLVeT8uoSQrxjDQ3Btu-7bqcOeSO8HscNOWY,454
+ame/core/errors.py,sha256=C6tL1pjeF60Wa1nA2TfmhR6LuREZVW-z0D50WC1_t70,269
+ame/core/paths.py,sha256=IjN9CysOIWHgi6yGqnPbtAoWsG99CLjdpJ72RMqgp5M,3908
+ame/core/state.py,sha256=6SctWnWjnK0eoqVkETiJX5zh9OXdLpOkdNM8ifAiTnk,1814
+ame/export/obsidian.py,sha256=ksHJ7sjutkBQP9tZ-N2cOOeY4Tw-6cOgLNEM7mysWMs,4819
+ame/gold/builder.py,sha256=ua3GviYHyFQWMqTHhj2heAkeRuG57beUQ0RFE6Zhtk4,13538
+ame/gold/ontology.py,sha256=SLatBzamyLbfqMgSJC-GzW3sWN5DwRfXVBRajCyuKyE,2904
+ame/gold/resolver.py,sha256=cByCAztUxc_jrA5DoIug8jnH8PKdXngGzN4no7yjA7k,4343
+ame/gold/schema.py,sha256=RryezcHJaFLIUXVw2wx2yVczr9xWuGVlRaIDTtoeybw,897
+ame/gold/store.py,sha256=Sn4WZmUob-tDbf1eV0Y4U4F1ehor18nINZJB9VaAVZA,1623
+ame/hardware/profiler.py,sha256=nK0VM69SXWcyby3B-5RWeoLpp_uVZutkTiA-7jEGBtc,2958
+ame/hardware/tier.py,sha256=tDHgMb55E3izCh_diHbTZj8D6HvRU1SlWXz17zK3KvE,612
+ame/hermes/__init__.py,sha256=bPxj3F4MzGO2vVucELbA75Iio0oVecGz0SyEqYkpwws,115
+ame/hermes/memory.py,sha256=tIE-4cqKDgXvSg0W0SY72nIen-KwyxRQuBr_Zi9dC-c,7703
+ame/models/download.py,sha256=dtcAsHNoPK09gxzVn-32bBdcmvH4_3GxTN7iNEULM8U,9142
+ame/models/ollama.py,sha256=1XAq7ruD54Scu9sYYUmukfgRKLdjrp-ZgQ-F3LzsAHc,2482
+ame/models/registry.py,sha256=be_hXnUhuT7A6Z6lyinAjoDAsiRUT6d2WtzsdM4N6qo,3183
+ame/models/router.py,sha256=nb-SF_zrtmUS4jAwR1iGZG5XjEnXNJZ4aAmn9M1Fz60,627
+ame/query/diff.py,sha256=PTAnSnbBuRzV0nkO-dlzfXApShBjH6hwedd0Yf3Z52M,1566
+ame/query/engine.py,sha256=7rYrvtTcBSbhXk8SzOXnyf2KoOcQBWrFOtCWxRtrdR0,49391
+ame/query/memory_os.py,sha256=mEducf8bbX_ncq_-j2ltBNfd8oimqdt7Qb4UNfDHZrY,14314
+ame/query/mql.py,sha256=VGRAIF0vY0o2ajyq3-owftT7pfrzFHTtvSuCMNF_2Xc,4016
+ame/query/multihop.py,sha256=gP7csjHTkSJvDIsZmGhSk8dgIiOujAwDBJDaqO0013c,14126
+ame/query/result.py,sha256=-HWAcS-qgH05J60PTP2sZdZwTre6b8b4rSgAlJwGkIM,443
+ame/silver/extractor.py,sha256=7BiItp5aS91zpR-2pZwCWdLY4HDAlen-XUJLllzTuaI,17505
+ame/silver/llm_extractor.py,sha256=XzG4I_wYWf9QsZHa9YaGXtsXNMgvfAP1yYLEkYf6R5Y,7238
+ame/silver/prompts.py,sha256=WttKMa8Pp3PkNaPrMt33sHmFjk4dUtCQ16GrwSUryDg,1460
+ame/silver/rationale.py,sha256=j5Quw1p4njP5j-02a_f_X5t-zWMoKJrl1Qxd5XGYtp8,7604
+ame/silver/schema.py,sha256=VMt7eFSTNZkRKdqA8R0OGpYVsd2ZXt5TXWy7i-tNmdk,1124
+ame/silver/store.py,sha256=Q9pul18dKR-we4pKhk-aZ_RkxsNUOsWR-yMQz1ZBiBE,2090
+ame/storage/custom_kg.py,sha256=bEuXwm3hmEaXbCCT-u1J8VWjZtv0N2HjMNUWGvK0XfQ,1067
+ame/storage/lightrag_adapter.py,sha256=rPQvRSV1_r4Y4lAHkGpZtWGs9TbE92blKHM2GaMyQE0,13905
+ame/validation/confidence.py,sha256=20ubx38radqSXNYTlp4Qq6F3pBO33qVruBCrz46UE5g,146
+ame/validation/grounding.py,sha256=idChqg4-Lmn1OLVQQjslo4OhuGUT5ThTdhPJ9y13Tv8,365
+ame/validation/type_gate.py,sha256=PfSjGJ3Ss_B9wrMqBFPbt0nUF9FE2196CSLzn9hQtJU,772
+memory/__init__.py,sha256=ZIxgpSnOFQiQ0opDjEudm2YloksTf5Fxmq5lYkU7jQM,49
+adaptive_memory_engine-0.1.6.dist-info/METADATA,sha256=mWfnOuDT3dG4bbwSPrnvI9oeRakpS5lVAI6A5NVKmlI,7612
+adaptive_memory_engine-0.1.6.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+adaptive_memory_engine-0.1.6.dist-info/entry_points.txt,sha256=dRy7OJaLLCCKhCYVgB0PMaHCIDO-GT_zMC0iYq9_Lt4,67
+adaptive_memory_engine-0.1.6.dist-info/licenses/LICENSE,sha256=4GK6MJzvAutgznpDs4Lw2MUKY6W1t3tRTXHkt8ZR_k8,1092
+adaptive_memory_engine-0.1.6.dist-info/RECORD,,

adaptive_memory_engine-0.1.6.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

adaptive_memory_engine-0.1.6.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ame = ame.cli.main:app
+memory = ame.cli.main:app

adaptive_memory_engine-0.1.6.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adaptive Memory Engine contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ame/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

ame/agent/__init__.py

@@ -0,0 +1 @@
+"""Agent-facing Memory API."""