# Botscent > Botscent is a small open-source library (MIT) that tells a site if an AI agent, not a person, is browsing it, and which agent. It has a server half (TypeScript and Python) that reads what one request declares, and a page half (about 5 KB gzipped, no network requests) that watches the page for evidence of an agent. Both return `{ type: 'agent' | 'human', agent_name?, reasons }`. `human` means no agent evidence was found. Use Botscent to adapt a page for agents, to measure agent traffic, or, with `isVerified`, to let a verified agent through. It does not block anything by itself. ## Install - [Install guide for coding agents](https://botscent.nibnalin.me/install.md): detect the stack, install, add both halves, and run `npx botscent check `. - [Agent Skill](https://botscent.nibnalin.me/.well-known/agent-skills/botscent/SKILL.md): install it with `npx skills add https://botscent.nibnalin.me`. ## Get started - [Introduction](https://botscent.nibnalin.me/docs.md): What Botscent is, what its two halves do, and what it does not do. - [Quickstart](https://botscent.nibnalin.me/docs/quickstart.md): Install Botscent with one prompt to your coding agent, or with the page for your framework. - [Verify your install](https://botscent.nibnalin.me/docs/verify.md): Run the Botscent check against your site, read each line, and fix what fails. ## Frameworks - [Next.js](https://botscent.nibnalin.me/docs/nextjs.md): Add both halves of Botscent to a Next.js app and check the install. - [React](https://botscent.nibnalin.me/docs/react.md): Add the page half of Botscent to a React app without a framework and check the install. - [Vue](https://botscent.nibnalin.me/docs/vue.md): Add the page half of Botscent to a Vue app and check the install. - [Nuxt](https://botscent.nibnalin.me/docs/nuxt.md): Add both halves of Botscent to a Nuxt app and check the install. - [SvelteKit](https://botscent.nibnalin.me/docs/sveltekit.md): Add both halves of Botscent to a SvelteKit app and check the install. - [Astro](https://botscent.nibnalin.me/docs/astro.md): Add both halves of Botscent to an Astro site with one integration and check the install. - [A script tag](https://botscent.nibnalin.me/docs/script-tag.md): Add the page half of Botscent to any page with one script tag and check the install. - [Express](https://botscent.nibnalin.me/docs/express.md): Add the server half of Botscent to an Express app and check the install. - [Hono](https://botscent.nibnalin.me/docs/hono.md): Add the server half of Botscent to a Hono app and check the install. - [Cloudflare Workers](https://botscent.nibnalin.me/docs/cloudflare-workers.md): Add the server half of Botscent to a Cloudflare Worker and check the install. - [Netlify](https://botscent.nibnalin.me/docs/netlify.md): Add the server half of Botscent to a Netlify site as an Edge Function and check the install. - [Vercel](https://botscent.nibnalin.me/docs/vercel.md): Add the server half of Botscent to a Vercel project as Routing Middleware and check the install. - [FastAPI and Starlette](https://botscent.nibnalin.me/docs/fastapi.md): Add the server half of Botscent to a FastAPI or Starlette app and check the install. - [Django](https://botscent.nibnalin.me/docs/django.md): Add the server half of Botscent to a Django project and check the install. - [Flask](https://botscent.nibnalin.me/docs/flask.md): Add the server half of Botscent to a Flask app and check the install. - [Any other server](https://botscent.nibnalin.me/docs/other-servers.md): Call inspect on each request in a server that has no Botscent adapter, in TypeScript or Python. ## Concepts - [How it works](https://botscent.nibnalin.me/docs/how-it-works.md): What each half of Botscent reads, when each half sees evidence, and how the halves share a verdict. - [The verdict](https://botscent.nibnalin.me/docs/verdict.md): What the three keys of a verdict mean, and how Botscent chooses the reasons and the agent name. - [From the server to the page](https://botscent.nibnalin.me/docs/server-to-page.md): How the server half sends the request's own verdict to the page in a Server-Timing entry, and when. - [From the page to the server](https://botscent.nibnalin.me/docs/page-to-server.md): How your code sends the page verdict to your server, and how the server keeps it apart. - [The trust model](https://botscent.nibnalin.me/docs/trust-model.md): Which verdict you can use to decide access, and what a verified signature proves. ## Guides - [Log verdicts for a week](https://botscent.nibnalin.me/docs/log-verdicts.md): Log the verdict of each page load on your server for a week, and change nothing for visitors. - [Measure agent traffic](https://botscent.nibnalin.me/docs/measure.md): Count the share of agent visits, the visits of each agent and each agent's top pages from your log. - [Adapt the page for agents](https://botscent.nibnalin.me/docs/adapt.md): Hide ads and banners, and show a plain list, when the page verdict becomes an agent. - [Change prices for agents](https://botscent.nibnalin.me/docs/prices.md): Compute an agent price on your server, in the direction that a forged verdict cannot exploit. - [Let a verified agent through](https://botscent.nibnalin.me/docs/verified-agents.md): Skip a challenge, a sign-in wall or a rate limit for an agent whose signature verified. ## Reference - [Page API](https://botscent.nibnalin.me/docs/page-api.md): Every function, attribute, event and framework binding of the page half. - [Server API (TypeScript)](https://botscent.nibnalin.me/docs/server-api.md): Every function, type and adapter of the TypeScript server half, with its options. - [Server API (Python)](https://botscent.nibnalin.me/docs/python-api.md): Every function and adapter of the Python server half, with its settings. - [npx botscent check](https://botscent.nibnalin.me/docs/check.md): Every flag, check, outcome, JSON field and exit code of the install check. - [Reasons](https://botscent.nibnalin.me/docs/reasons.md): Every reason id a verdict can carry, strongest first, and what each one means. - [Agents](https://botscent.nibnalin.me/docs/agents.md): Every agent Botscent can name: its vendor, its name in a verdict, and the evidence that names it. ## Project - [Privacy](https://botscent.nibnalin.me/docs/privacy.md): What Botscent reads, what it keeps and what it sends, probe by probe and header by header. - [Performance](https://botscent.nibnalin.me/docs/performance.md): What the page half costs a page, measured in a real browser against the same page without it. - [Versions and stability](https://botscent.nibnalin.me/docs/versions.md): What each kind of release can change, how to pin a version, and how signer keys age. - [Security and contributing](https://botscent.nibnalin.me/docs/security.md): How to report a vulnerability, what counts as one, how to contribute, and the license. ## Optional - [All docs in one file](https://botscent.nibnalin.me/llms-full.txt)