Skip to main content

Temporal-aware embedding model for AI agent memory retrieval. The first embedder that understands WHEN memories happened.

Project description

🧠 AgentRank

The first embedding model that understands WHEN memories happened.

PyPI version License HuggingFace


Why AgentRank?

Standard embeddings (OpenAI, Cohere, MiniLM) treat "yesterday" and "6 months ago" identically. For AI agent memory, this breaks everything.

AgentRank adds:

  • Temporal embeddings — 10 learnable time buckets so the model understands recency
  • Memory type embeddings — Distinguishes events, preferences, and instructions
  • 21% better retrieval on agent memory benchmarks

Installation

pip install agentrank

Quick Start

from agentrank import AgentRankEmbedder

# Load model
model = AgentRankEmbedder.from_pretrained("vrushket/agentrank-base")

# Encode with temporal context
embeddings = model.encode(
    texts=["User prefers Python for backend development"],
    temporal_info=[7],        # 7 days ago
    memory_types=["semantic"] # It's a preference
)

Models

Model Params Use Case HuggingFace
AgentRank-Base 149M Best quality vrushket/agentrank-base
AgentRank-Small 33M Fast inference vrushket/agentrank-small

Benchmarks

Model MRR Recall@5
AgentRank-Base 0.65 99.6%
AgentRank-Small 0.64 97.4%
all-mpnet-base-v2 0.54 79.6%
all-MiniLM-L6-v2 0.53 75.2%

Works Great With

CogniHive — Multi-agent memory system with "who knows what" routing

pip install cognihive

Together: CogniHive routes questions to the right agent, AgentRank retrieves the right memories.


Links


Contact


License

Apache 2.0 — Free for commercial use.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentrank-0.1.1.tar.gz (6.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentrank-0.1.1-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file agentrank-0.1.1.tar.gz.

File metadata

  • Download URL: agentrank-0.1.1.tar.gz
  • Upload date:
  • Size: 6.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for agentrank-0.1.1.tar.gz
Algorithm Hash digest
SHA256 2f1de1c7371bf1ba3b60510081db445947cb44edd118af7035832121c4021ede
MD5 9d5d5d5b5cdd69ce276858172dbdb1aa
BLAKE2b-256 ffbbd435df279bb934ca3a6218f9e0aec7c359abb0010dfa6f661fe126449b93

See more details on using hashes here.

File details

Details for the file agentrank-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: agentrank-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 6.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for agentrank-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8a046934ed06a66f4455cf57b46f0663fce12279624c6739c589197e298bef39
MD5 6d6afdf5f9ae7ea96889462e5d4c7e19
BLAKE2b-256 50960d7c30b486d0d16e32769ed86af50c1c04bdef4fe63b1189c469f9d2b5e0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page