Skip to main content

Shared browser interaction schema registry for AI agents. Reduces LLM token usage by 80-100% on known sites.

Project description

AgentAtlas

Shared browser interaction schema registry for AI agents.

Reduces LLM token usage by 80-100% on known sites by storing and sharing site interaction schemas across all users.

How it works

First user  → LLM learns the site → saved to shared registry
Every user after → 0 tokens, instant response

Benchmark results (real data)

Without AgentAtlas With AgentAtlas
Tokens 2,597 0-445
Cost $0.018 $0.000-$0.002
Time 19s 0.2-12s
Real URLs

82.9% token reduction when LLM still needed. 100% reduction for repeat workflows.

Install

pip install agentatlas
playwright install chromium

Usage

from agentatlas.atlas import Atlas

atlas = Atlas()

# Get schema for any site
# Found in registry → 0 tokens
# New site → learns once, saves for everyone
schema = await atlas.get_schema(
    site="greenhouse.io",
    url="https://boards.greenhouse.io/anthropic"
)

# Pass compact schema to YOUR LLM
# 150-500 tokens instead of 50,000
print(schema.elements)
print(schema.tokens_used)  # 0 if registry hit
print(schema.source)       # "registry" or "llm_learned"

Environment variables

SUPABASE_URL=your_supabase_url
SUPABASE_SERVICE_ROLE_KEY=your_key
OPENAI_API_KEY=your_key

The flywheel

More developers use AgentAtlas
        ↓
More new sites get learned automatically
        ↓
Registry grows → higher hit rate
        ↓
Less tokens burned across the whole network
        ↓
Cheaper + faster → more developers adopt

License

MIT

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

agentatlas-0.3.0.tar.gz (10.1 kB view details)

Uploaded Source

Built Distribution

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

agentatlas-0.3.0-py3-none-any.whl (9.5 kB view details)

Uploaded Python 3

File details

Details for the file agentatlas-0.3.0.tar.gz.

File metadata

  • Download URL: agentatlas-0.3.0.tar.gz
  • Upload date:
  • Size: 10.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.13

File hashes

Hashes for agentatlas-0.3.0.tar.gz
Algorithm Hash digest
SHA256 3f216c5efaf3e20597bb0c549b449e714af3e1a8ea38db77768cfed9ad1e66e6
MD5 2653fc5086e5e66b8275227f3cd003d1
BLAKE2b-256 bec33cb8cf62766a49f4a99a2b14311485b211de7275638e2b576c8a315934b8

See more details on using hashes here.

File details

Details for the file agentatlas-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: agentatlas-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 9.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.13

File hashes

Hashes for agentatlas-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9d83edd0e0d7b26d60b3b1c245e2e7bc8f239b33ebfc1a9e659bb8d1b7fe7b29
MD5 e2c92aed88852c4a66fb6a5a1061230b
BLAKE2b-256 3661a91c2b14a03b010f2641387e1640ff7944025a029da4b14ec117dedd210f

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