Agents are somewhat hard to build - you have to define the tools it can call, maybe find a code execution environment, figure out how to give it access to files, and the whole thing is hard to test.Trelent Agents makes it easy to build and run agents using Docker sandboxes. Your sandbox defines the tools the agent can use - just normal programs and CLI tools - and then you can create runs to execute prompts against it using your choice of harness (Claude Code, Codex, or Gemini) paired with a model.Testing is easy too, just exec into your docker container locally and install whichever coding agent you are most familiar with, and give it the prompt you want to test. It will have the exact same tools as your live Trelent Agent.
Quickstart
Build a sandbox and run your first agent.
Check out the agents-demo repo for a complete working example.
⌘I
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Trelent Docs","description":"Documentation for Trelent Data Ingestion, Agents, and Document Verification.","colors":{"primary":"#36c1da","light":"#36c1da","dark":"#36c1da"},"favicon":"https://www.trelent.com/trelent-favicon.png","api":{"playground":{"display":"simple"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"trelent","hasAudioNarration":false,"actualSubdomain":"trelent","customDomains":["docs.trelent.com"],"gitSource":{"type":"github","owner":"trelent","repo":"docs.trelent.com","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aa092c86b56d9f150533363","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Data Ingestion","count":22},{"language":"default","tag":"Document Verification","count":11},{"language":"default","tag":"Agents","count":10},{"language":"default","tag":"Getting started","count":10},{"language":"default","tag":"Core concepts","count":6},{"language":"default","tag":"API reference","count":6},{"language":"default","tag":"Connectors","count":4},{"language":"default","tag":"Admin","count":4},{"language":"default","tag":"Detections","count":4},{"language":"default","tag":"Configuration","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"agents","slug":"/agents","pageMetadata":{"title":"Trelent Agents","sidebarTitle":"Overview","description":"Build and run agents in Docker sandboxes.","href":"/agents/index"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Build and run agents in Docker sandboxes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Card,Info}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Agents are somewhat hard to build - you have to define the tools it can call, maybe find a code execution environment, figure out how to give it access to files, and the whole thing is hard to test.`}),`\n`,_jsx(_components.p,{children:`Trelent Agents makes it easy to build and run agents using Docker sandboxes. Your sandbox defines the tools the agent can use - just normal programs and CLI tools - and then you can create runs to execute prompts against it using your choice of harness (Claude Code, Codex, or Gemini) paired with a model.`}),`\n`,_jsx(_components.p,{children:`Testing is easy too, just exec into your docker container locally and install whichever coding agent you are most familiar with, and give it the prompt you want to test. It will have the exact same tools as your live Trelent Agent.`}),`\n`,_jsx(Card,{title:`Quickstart`,icon:`rocket`,href:`/agents/quickstart`,arrow:`true`,cta:`Get Started`,children:_jsx(_components.p,{children:`Build a sandbox and run your first agent.`})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Check out the `,_jsx(_components.a,{href:`https://github.com/Trelent/agents-demo`,children:`agents-demo`}),` repo for a complete working example.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Trelent Agents","sidebarTitle":"Overview","description":"Build and run agents in Docker sandboxes.","href":"/agents/index"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"trelent","siteName":"Trelent Docs","title":"Trelent Agents - Trelent Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-23T16:45:20.227Z","originalFileLocation":"agents/index.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Build and run agents in Docker sandboxes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Trelent Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://www.trelent.com/trelent-favicon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://www.trelent.com/trelent-favicon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://www.trelent.com/trelent-favicon.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://www.trelent.com/trelent-favicon.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Trelent Agents - Trelent Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Build and run agents in Docker sandboxes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Trelent Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trelent.com/agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://trelent.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Trelent+Agents\u0026amp;description=Build+and+run+agents+in+Docker+sandboxes.\u0026amp;theme=5f92e974fee7788b9d0d104e\u0026amp;signature=7a714eda95d2a9f238788a6f36b84215af379987cb60e95ceb4a7f9ad5a1fcac\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Trelent Agents - Trelent Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Build and run agents in Docker sandboxes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://trelent.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Trelent+Agents\u0026amp;description=Build+and+run+agents+in+Docker+sandboxes.\u0026amp;theme=5f92e974fee7788b9d0d104e\u0026amp;signature=7a714eda95d2a9f238788a6f36b84215af379987cb60e95ceb4a7f9ad5a1fcac\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/trelent/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Trelent Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#36c1da\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trelent.com/agents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/agents.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trelent.com/#organization\",\"name\":\"Trelent Docs\",\"url\":\"https://docs.trelent.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trelent.com#website\",\"name\":\"Trelent Docs\",\"url\":\"https://docs.trelent.com\",\"publisher\":{\"@id\":\"https://docs.trelent.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trelent.com/agents#webpage\",\"url\":\"https://docs.trelent.com/agents\",\"name\":\"Trelent Agents\",\"description\":\"Build and run agents in Docker sandboxes.\",\"dateModified\":\"2026-04-23T16:45:20.227Z\",\"isPartOf\":{\"@id\":\"https://docs.trelent.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trelent.com/agents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trelent.com/agents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting started\",\"item\":\"https://docs.trelent.com/agents/index\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Trelent Agents\",\"item\":\"https://docs.trelent.com/agents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.trelent.com/agents#article\",\"headline\":\"Trelent Agents\",\"name\":\"Trelent Agents\",\"description\":\"Build and run agents in Docker sandboxes.\",\"url\":\"https://docs.trelent.com/agents\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trelent.com/agents#webpage\"},\"dateModified\":\"2026-04-23T16:45:20.227Z\",\"publisher\":{\"@id\":\"https://docs.trelent.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trelent.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Trelent Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Trelent Docs","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Agents","groups":[{"group":"Getting started","icon":"rocket","pages":[{"title":"Trelent Agents","sidebarTitle":"Overview","href":"/agents"},{"title":"Quickstart","description":"Build a translator sandbox and run your first agent.","href":"/agents/quickstart"},{"title":"Authentication","href":"/agents/authentication"}]},{"group":"Core concepts","icon":"sparkles","pages":[{"title":"Runs","href":"/agents/runs"},{"title":"Sandboxes","href":"/agents/sandboxes"},{"title":"Harnesses \u0026 Models","href":"/agents/harnesses"},{"title":"Imports \u0026 Exports","href":"/agents/imports-and-exports"},{"title":"Forking","href":"/agents/forking"},{"title":"Full Example","href":"/agents/example"}]},{"group":"Importers","icon":"arrow-down-to-bracket","pages":[{"title":"LocalImporter","href":"/agents/importers/local"}]}]},{"tab":"Data Ingestion","pages":[{"title":"Data Ingestion","href":"/data-ingestion"}]},{"tab":"Document Verification","pages":[{"title":"Document Verification","href":"/document-verification"}]}]},"basePath":"","title":"Trelent Agents - Trelent Docs","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":[],"chunks":[]}