Metadata-Version: 2.4
Name: memgentic-api
Version: 0.8.0
Summary: REST API for Memgentic — memory search, management, skills, and real-time updates
Project-URL: Homepage, https://github.com/Chariton-kyp/Memgentic
Project-URL: Repository, https://github.com/Chariton-kyp/Memgentic
Project-URL: Documentation, https://github.com/Chariton-kyp/Memgentic/blob/main/docs/API_GUIDE.md
Project-URL: Issues, https://github.com/Chariton-kyp/Memgentic/issues
Project-URL: Changelog, https://github.com/Chariton-kyp/Memgentic/blob/main/memgentic-api/CHANGELOG.md
Project-URL: Source, https://github.com/Chariton-kyp/Memgentic/tree/main/memgentic-api
Author-email: Chariton Kypraios <chariton@ellinai.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agents,ai,fastapi,llm,memgentic,memory,rag,rest-api,skills
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: fastapi>=0.130
Requires-Dist: memgentic[intelligence]
Requires-Dist: python-multipart>=0.0.26
Requires-Dist: slowapi>=0.1
Requires-Dist: uvicorn[standard]>=0.34
Provides-Extra: dev
Requires-Dist: httpx>=0.28; extra == 'dev'
Requires-Dist: pytest-asyncio>=1.0; extra == 'dev'
Requires-Dist: pytest>=9.0.3; extra == 'dev'
Description-Content-Type: text/markdown

# memgentic-api

**REST API for [Memgentic](https://pypi.org/project/memgentic/)** — memory search, management, and real-time updates. Built on FastAPI + `memgentic`'s intelligence extras.

```bash
pip install memgentic-api
memgentic-api serve            # http://localhost:8100
```

## What it exposes

| Surface | Endpoints |
|---|---|
| **Memories** | CRUD, pinned, related, semantic/keyword search, batch update, topic autocomplete |
| **Collections** | User-defined groups with CRUD + membership |
| **Skills** | Agent Skills standard — create, file management, distribute to AI tools |
| **Uploads** | Text, file (.md/.txt/.pdf/.docx), URL import |
| **Persona** | Read + patch the T0 persona card |
| **Briefing** | Recall Tiers (T0–T4) rendered server-side |
| **Watchers** | Cross-tool capture install/enable/status/logs |
| **Chronograph** | Bitemporal knowledge-graph query + mutate |
| **WebSocket** | Real-time activity feed |

Full endpoint reference: [docs/API_GUIDE.md on GitHub](https://github.com/Chariton-kyp/Memgentic/blob/main/docs/API_GUIDE.md).

## Why separate from the core package?

`memgentic` (the core) is an **extractable library** — the CLI, MCP server, ingestion pipeline, and storage layer all live there with no FastAPI dependency. Installing `memgentic-api` pulls in the REST surface + the `intelligence` extras so the dashboard and external clients can hit HTTP.

For the full architecture + MCP-vs-REST trade-off, see the [root README](https://github.com/Chariton-kyp/Memgentic).

## License

Apache 2.0. See [LICENSE](https://github.com/Chariton-kyp/Memgentic/blob/main/LICENSE).
