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.2.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.2-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agentrank-0.1.2.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.2.tar.gz
Algorithm Hash digest
SHA256 366cf88b7a64a236bf37f5d5cc66bf44a947bb6ec8b55f2c930ea6daffb3b581
MD5 f7fbdc2468a5c180cd2a9cab3d398518
BLAKE2b-256 240aa228d3764ead37b89493eac94549d5e14e00c2780d1aaf01cfe53206783a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: agentrank-0.1.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c8647c579b512a0b6b1c002de0b994c3cd052b37e602513fffee77d7b81b6f7c
MD5 65a72428aa5ad4edb7397479e87acd26
BLAKE2b-256 9ffee13783b59773bfb00bc67946051c32e97049369e9984902db343fea03451

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