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.2.0.tar.gz (11.6 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.2.0-py3-none-any.whl (13.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for agentatlas-0.2.0.tar.gz
Algorithm Hash digest
SHA256 c54997153fe91bf51eaf7cf04aa8ab29226d1a42710eac7b36bbdf61814062ad
MD5 d18c848f4c81035996ed8db06d4f136d
BLAKE2b-256 7ae55311b8790f97d444129300f584e5fb0eaa1a7cf38649893364fe3b1db6ce

See more details on using hashes here.

File details

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

File metadata

  • Download URL: agentatlas-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 13.4 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.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6e2acc66195901719f3b0acb4dd5850ae364cfdaeb12a5f5947a1df37c3a6633
MD5 14db236cc5c0b9925cd2f1031124e089
BLAKE2b-256 17a702631a81cd393f1d3c03c0f7a3758588b660d358479d4cbf840ec3eea21c

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