Who it is forA developer building a custom agent who needs a local memory service running before connecting a client.
The problemYou cannot tell whether the AMA sidecar is running correctly before adding it to your agent.
The outcomeThe AMA sidecar runs on localhost and returns a health response you can check.
What you need first
- Python 3.10 or newer
- Node.js 22.22.3 or newer (24.15 or newer also supported)
- pnpm 11 or newer
- An OpenAI-compatible chat-completions endpoint and embedding endpoint, with an API key
- Git, to clone the repository
Steps
git clone https://github.com/Sherlockwz/AMA.gitcd AMAcorepack enable pnpm./scripts/setup.sh.venv/bin/python -m uvicorn python.server:app --host 127.0.0.1 --port 8321curl http://127.0.0.1:8321/health
Prompt for your agent
In the AMA repo at <path-to-AMA>, start the sidecar with the uvicorn command from the README on port 8321, then call the /health endpoint. Expected output: the raw health response body. Verify that the server is bound to 127.0.0.1 and not a public interface before reporting success.
Caveat. The README only shows a health check as the smoke test, so a successful response does not prove that memory retrieval or LLM calls work.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for Sherlockwz/AMA and "Start the AMA memory sidecar and confirm it responds"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer