{"_id":"n-agents","_rev":"2-93945a2756829bc13aa854a231ff46bf","name":"n-agents","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"n-agents","version":"1.0.0","keywords":["ai","agent","ollama","llm","automation","tools","nodejs"],"author":{"name":"solidsnail"},"license":"MIT","_id":"n-agents@1.0.0","maintainers":[{"name":"rdaoudi","email":"rachiduoad@gmail.com"}],"homepage":"https://github.com/solidsnail/n-agents#readme","bugs":{"url":"https://github.com/solidsnail/n-agents/issues"},"dist":{"shasum":"0f99134f177aa2bd83a80603fc6d679cb1c29295","tarball":"https://registry.npmjs.org/n-agents/-/n-agents-1.0.0.tgz","fileCount":1291,"integrity":"sha512-CfWhKIrUPgHsz/RqsIbeYFu1A8xCyqDwf7itP/Z1xY1AyN3ZlMRtHNxf9nbZ0UNqajdsyNJX1jQF4I/Z7Ipv2A==","signatures":[{"sig":"MEQCIAnaIn0th2FzpCK7DJwIv+78VPUn6/vva0/ekf0pAHobAiAYNhfEkegXE/bqAFgUarxYzhpSblkknzwdkd8PVCTmLQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4912389},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"./package.json":"./package.json"},"gitHead":"e16292ed1cc3147dc23c3dbbe56738e9ead93ebc","scripts":{"lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.build.json","clean":"rm -rf dist","format":"prettier --write .","readme":"npx readme.jsx ./README.jsx","lint:fix":"eslint . --fix","prebuild":"npm run clean","typecheck":"tsc --noEmit","example:file":"tsx examples/file-workflow.ts","example:http":"tsx examples/http.ts","format:check":"prettier --check .","example:image":"tsx examples/image.ts","example:github":"tsx examples/github.ts","prepublishOnly":"npm run typecheck && npm run lint && npm run build && npm run test","example:browser":"tsx examples/browser.ts","example:registry":"tsx examples/registry.ts","example:wikidata":"tsx examples/wikidata.ts","example:multi-agent":"tsx examples/multi-agent.ts","example:custom-agent":"tsx examples/custom-agent.ts"},"_npmUser":{"name":"rdaoudi","email":"rachiduoad@gmail.com"},"repository":{"url":"git+https://github.com/solidsnail/n-agents.git","type":"git"},"_npmVersion":"11.11.0","description":"A lightweight, composable AI agent framework for Node.js — powered by Ollama.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.0","dependencies":{"pg":"^8.14.0","sharp":"^0.35.3","dotenv":"^16.4.5","ollama":"^0.5.1","evernote":"^2.0.5","basic-ftp":"^5.0.5","googleapis":"^140.0.0","googlethis":"^1.8.0","ghost-cursor":"^1.2.0","simple-icons":"^16.27.0","@iconify/json":"^2.2.501","puppeteer-extra":"^3.3.6","ssh2-sftp-client":"^12.1.1","rebrowser-puppeteer":"^23.0.0","@aws-sdk/client-cloudwatch":"^3.1090.0","puppeteer-extra-plugin-stealth":"^2.11.2","puppeteer-extra-plugin-adblocker":"^2.13.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","eslint":"^9.0.0","vitest":"^2.0.0","prettier":"^3.0.0","@types/pg":"^8.11.13","readme.jsx":"^0.6.9","typescript":"^5.0.0","@types/node":"^20.0.0","@types/sharp":"^0.31.1","@types/evernote":"^2.0.5","typescript-eslint":"^8.0.0","eslint-config-prettier":"^9.0.0","eslint-plugin-prettier":"^5.0.0","@types/ssh2-sftp-client":"^9.0.0"},"_npmOperationalInternal":{"tmp":"tmp/n-agents_1.0.0_1784728179143_0.6827802927374023","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"n-agents","version":"1.1.0","description":"A lightweight, composable AI agent framework for Node.js — powered by Ollama.","type":"module","main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"./package.json":"./package.json"},"sideEffects":false,"scripts":{"test":"vitest run","build":"tsc -p tsconfig.build.json","clean":"rm -rf dist","prebuild":"npm run clean","typecheck":"tsc --noEmit","lint":"eslint .","lint:fix":"eslint . --fix","format":"prettier --write .","format:check":"prettier --check .","prepublishOnly":"npm run typecheck && npm run lint && npm run build","example:browser-weather":"tsx examples/browser-weather/index.ts","example:custom-agent":"tsx examples/custom-agent/index.ts","example:github":"tsx examples/github/index.ts","example:http-hackernews":"tsx examples/http-hackernews/index.ts","example:image":"tsx examples/image/index.ts","example:image-to-html":"tsx examples/image-to-html/index.ts","example:image-to-react":"tsx examples/image-to-react/index.ts","example:multi-agent":"tsx examples/multi-agent/index.ts","example:registry":"tsx examples/registry/index.ts","example:researcher-writer":"tsx examples/researcher-writer/index.ts","example:wikidata":"tsx examples/wikidata/index.ts","readme":"npx readme.jsx ./README.jsx"},"keywords":["ai","agent","ollama","llm","automation","tools","nodejs"],"author":{"name":"solidsnail"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/solidsnail/n-agents.git"},"bugs":{"url":"https://github.com/solidsnail/n-agents/issues"},"homepage":"https://github.com/solidsnail/n-agents#readme","engines":{"node":">=18"},"publishConfig":{"access":"public"},"dependencies":{"@aws-sdk/client-cloudwatch":"^3.1090.0","@iconify/json":"^2.2.501","dotenv":"^16.4.5","evernote":"^2.0.5","ghost-cursor":"^1.2.0","googleapis":"^140.0.0","googlethis":"^1.8.0","ollama":"^0.5.1","pg":"^8.14.0","puppeteer-extra":"^3.3.6","puppeteer-extra-plugin-adblocker":"^2.13.6","puppeteer-extra-plugin-stealth":"^2.11.2","rebrowser-puppeteer":"^23.0.0","sharp":"^0.35.3","simple-icons":"^16.27.0","basic-ftp":"^5.0.5","ssh2-sftp-client":"^12.1.1"},"devDependencies":{"@types/evernote":"^2.0.5","@types/node":"^20.0.0","@types/pg":"^8.11.13","@types/sharp":"^0.31.1","@types/ssh2-sftp-client":"^9.0.0","eslint":"^9.0.0","eslint-config-prettier":"^9.0.0","eslint-plugin-prettier":"^5.0.0","prettier":"^3.0.0","readme.jsx":"^0.6.9","tsx":"^4.0.0","typescript":"^5.0.0","typescript-eslint":"^8.0.0","vitest":"^2.0.0"},"_id":"n-agents@1.1.0","gitHead":"beb31deceeb8cfeca9a25f8ef01e7f6478d4c869","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-MO7/2gUL1LIMgOEQvbJTZSQMpgbDb87c8t/lQ+lgKisow5HbXG3Jg8lIDZkLSP3tnqnEcW/krS7ovYe/UARByA==","shasum":"2bcdddebf109917e31bb0274dd53e3921218cb37","tarball":"https://registry.npmjs.org/n-agents/-/n-agents-1.1.0.tgz","fileCount":1292,"unpackedSize":4910886,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCqhATw9X6PrXH07ZbzLeG+5u9kLDUT0qjVhDWBjrF8NAIgNY7duefj1V2wAnbsK+1xFgEXE0anMzXBdlrFsSc/WPQ="}]},"_npmUser":{"name":"rdaoudi","email":"rachiduoad@gmail.com"},"directories":{},"maintainers":[{"name":"rdaoudi","email":"rachiduoad@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n-agents_1.1.0_1785084404457_0.354450638350982"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-22T13:49:38.918Z","modified":"2026-07-26T16:46:44.777Z","1.0.0":"2026-07-22T13:49:39.302Z","1.1.0":"2026-07-26T16:46:44.619Z"},"bugs":{"url":"https://github.com/solidsnail/n-agents/issues"},"author":{"name":"solidsnail"},"license":"MIT","homepage":"https://github.com/solidsnail/n-agents#readme","keywords":["ai","agent","ollama","llm","automation","tools","nodejs"],"repository":{"type":"git","url":"git+https://github.com/solidsnail/n-agents.git"},"description":"A lightweight, composable AI agent framework for Node.js — powered by Ollama.","maintainers":[{"name":"rdaoudi","email":"rachiduoad@gmail.com"}],"readme":"

\n\n

A lightweight, composable AI agent framework for Node.js — powered by Ollama.

\n

\"version\" \"runtime\" \"language\" \"LLM\" \"license\"

\n

\n\n## Overview\n\n**n-agents** is a minimal yet powerful framework for building AI-powered agents in Node.js. Each agent is a self-contained specialist that uses LLM reasoning (via Ollama) to autonomously execute multi-step tasks by calling tools — no chat required.\n\n- 🧩 **Composable** — Mix and match pre-built tools to create custom agents\n- 🔧 **Tool-driven** — Agents act by calling typed tool functions, not by chatting\n- 🛡️ **Stealth browser** — Built-in Puppeteer agent with anti-detection and human-like behavior\n- ☁️ **Cloud or local** — Connect to Ollama Cloud or run models locally\n- 📦 **Zero boilerplate** — 146 ready-to-use agents for GitHub, Slack, Jira, Gmail, and more\n- 🔄 **Auto-recovery** — Agents retry on tool failures and self-correct hallucinations\n\n## Examples\n\nReal-world tasks executed autonomously by n-agents.\n\n
\n\n**Code Snippet**\n\n\n\n**Input**\n\n\n\n**Output**\n\n
\n\n```javascript\nconst result = await agent.execute({\n instructions: [\n \"Grayscale then resize to 200x200 the image ./apples.jpg\",\n \"Save the result to ./examples/image/output/apples-processed.jpg\",\n ],\n});\n```\n\n\n\n\"apples.jpg\"\n\n\n\n\"apples-processed.jpg\"\n\n
\n\n```javascript\nconst result = await agent.execute({\n instructions: [\n \"Transform the UI image at ./examples/image-to-html/ui-mockup.png into a self-contained HTML page with embedded CSS\",\n \"Save the generated HTML file to ./examples/image-to-html/output/generated-ui.html\",\n ],\n});\n```\n\n\n\n\"ui-mockup.png\"\n\n\n\ngenerated-ui.html\n\n
\n\n```javascript\nconst result = await agent.execute({\n instructions: [\n \"Transform the UI image at ./examples/image-to-react/ui-mockup.png into a React TypeScript component\",\n \"Save the generated TSX code to ./examples/image-to-react/output/generated-ui.tsx\",\n ],\n});\n```\n\n\n\n\"ui-mockup.png\"\n\n\n\ngenerated-ui.tsx\n\n
\n\n```javascript\nconst result = await agent.execute({\n instructions: [\n \"Go to https://duckduckgo.com/?q=weather&ia=web\",\n \"Take a screenshot of the element '[data-layout=\\\"forecast\\\"]'\",\n \"Save it to ./examples/browser-weather/output/weather.png\",\n ],\n});\n```\n\n\n\nduckduckgo.com/weather\n\n\n\n\"weather.png\"\n\n
\n\n```javascript\nconst researchResult = await researcher.execute({\n instructions: [\n 'Research topic \"the impact of AI agents on software engineering\" using public web sources',\n ],\n});\n\nconst writeResult = await writer.execute({\n instructions: [\n \"Write a polished Markdown article based on the research brief and save to ./examples/researcher-writer/output/the_impact_of_ai_agents_on_software_engineering.md\",\n ],\n});\n```\n\n\n\n\"the impact of AI agents on software engineering\"\n\n\n\nthe_impact_of_ai_agents_on_software_engineering.md\n\n
\n\n```javascript\nconst researchResult = await httpAgent.execute({\n instructions: [\n \"Fetch Wikipedia info for 5 landmark space exploration missions\",\n ],\n});\n\nconst reportResult = await reportWriterAgent.execute({\n instructions: [\n \"Generate a clean Markdown report with embedded images and save to ./examples/multi-agent/output/report.md\",\n ],\n});\n```\n\n\n\n5 space missions: Apollo_11, Voyager_1, JWST, Curiosity, Artemis_1\n\n\n\nreport.md\n\n
\n\n## Available Agents\n\nThe library ships with 146 pre-configured agents across 19 categories. Each agent is created via a factory function and can be customized with partial overrides.\n\n
🔧 Source Control (6)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**GitHub**\n\n\n\nRepositories, branches, PRs, issues, and releases via the GitHub API.\n\n\n\nGITHUB_TOKEN\n\n
\n\n\n\n\n\n**GitLab**\n\n\n\nProjects, branches, merge requests, issues, and releases via the GitLab API.\n\n\n\nGITLAB_TOKEN GITLAB_HOST\n\n
\n\n\n\n\n\n**Bitbucket**\n\n\n\nRepositories, branches, PRs, issues, and pipelines via the Bitbucket API.\n\n\n\nBITBUCKET_TOKEN\n\n
\n\n\n\n\n\n**Git**\n\n\n\nBranches, commits, diffs, and file operations in the local repository.\n\n\n\n—\n\n
\n\n\n\n\n\n**Linear**\n\n\n\nModern software development issue tracking.\n\n\n\nLINEAR_API_KEY\n\n
\n\n\n\n\n\n**Docker**\n\n\n\nContainer management and orchestration.\n\n\n\nDOCKER_HOST\n\n
🚨 Monitoring (4)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**PagerDuty**\n\n\n\nIncident response and on-call management.\n\n\n\nPAGERDUTY_API_KEY PAGERDUTY_FROM_EMAIL\n\n
\n\n\n\n\n\n**Datadog**\n\n\n\nCloud monitoring and analytics.\n\n\n\nDATADOG_API_KEY DATADOG_APP_KEY\n\n
\n\n\n\n\n\n**Sentry**\n\n\n\nError tracking and performance monitoring.\n\n\n\nSENTRY_AUTH_TOKEN\n\n
\n\n\n\n\n\n**AWS CloudWatch**\n\n\n\nCloud resources monitoring.\n\n\n\nAWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_REGION\n\n
💬 Communication (8)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Slack**\n\n\n\nChannels, messages, files, reactions, stars, users, and user groups.\n\n\n\nSLACK_TOKEN\n\n
\n\n\n\n\n\n**Discord**\n\n\n\nBot integration for reading, managing, and sending messages.\n\n\n\nDISCORD_TOKEN\n\n
\n\n\n\n\n\n**Microsoft Teams**\n\n\n\nTeams, channels, and messages via Microsoft Graph API.\n\n\n\nMICROSOFT_TEAMS_TOKEN\n\n
\n\n\n\n\n\n**Telegram**\n\n\n\nGet updates and send messages via the Telegram Bot API.\n\n\n\nTELEGRAM_TOKEN\n\n
\n\n\n\n\n\n**WhatsApp**\n\n\n\nSend messages and fetch templates via the WhatsApp Business API.\n\n\n\nWHATSAPP_TOKEN WHATSAPP_PHONE_NUMBER_ID\n\n
\n\n\n\n\n\n**Twilio**\n\n\n\nSend SMS messages and make voice calls.\n\n\n\nTWILIO_ACCOUNT_SID TWILIO_AUTH_TOKEN TWILIO_PHONE_NUMBER\n\n
\n\n\n\n\n\n**Webex**\n\n\n\nSend messages and create meetings via the Webex API.\n\n\n\nWEBEX_TOKEN\n\n
\n\n\n\n\n\n**Mattermost**\n\n\n\nSend messages and get channel details.\n\n\n\nMATTERMOST_URL MATTERMOST_TOKEN\n\n
📹 Video (2)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Zoom**\n\n\n\nCreate and manage meetings via the Zoom API.\n\n\n\nZOOM_TOKEN\n\n
\n\n\n\n\n\n**Google Meet**\n\n\n\nCreate and list meetings via the Google Calendar API.\n\n\n\nGOOGLE_MEET_TOKEN\n\n
📧 Email (10)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Gmail**\n\n\n\nDrafts, labels, messages, and threads via the Gmail API.\n\n\n\nGMAIL_ACCESS_TOKEN\n\n
\n\n\n\n\n\n**Outlook**\n\n\n\nOffice 365 email management.\n\n\n\nOUTLOOK_API_KEY\n\n
\n\n\n\n\n\n**Mailchimp**\n\n\n\nManage audiences and campaigns.\n\n\n\nMAILCHIMP_API_KEY\n\n
\n\n\n\n\n\n**SendGrid**\n\n\n\nTransactional email delivery.\n\n\n\nSENDGRID_API_KEY\n\n
\n\n\n\n\n\n**ActiveCampaign**\n\n\n\nEmail automation and CRM.\n\n\n\nACTIVECAMPAIGN_BASE_URL ACTIVECAMPAIGN_API_KEY\n\n
\n\n\n\n\n\n**Klaviyo**\n\n\n\nEcommerce marketing automation.\n\n\n\nKLAVIYO_API_KEY\n\n
\n\n\n\n\n\n**Brevo (Sendinblue)**\n\n\n\nEmail and SMS marketing.\n\n\n\nBREVO_API_KEY\n\n
\n\n\n\n\n\n**Mailgun**\n\n\n\nEmail API integration.\n\n\n\nMAILGUN_API_KEY MAILGUN_DOMAIN\n\n
\n\n\n\n\n\n**ConvertKit**\n\n\n\nCreator marketing platform.\n\n\n\nCONVERTKIT_API_KEY\n\n
\n\n\n\n\n\n**Postmark**\n\n\n\nFast transactional email delivery.\n\n\n\nPOSTMARK_API_KEY\n\n
📱 Social (10)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Instagram**\n\n\n\nUser profiles, media, and comments via the Instagram Graph API.\n\n\n\nINSTAGRAM_ACCESS_TOKEN\n\n
\n\n\n\n\n\n**TikTok**\n\n\n\nUser profiles, videos, and analytics via the TikTok Open API.\n\n\n\nTIKTOK_ACCESS_TOKEN\n\n
\n\n\n\n\n\n**Reddit**\n\n\n\nPosts, comments, subreddits, and user information.\n\n\n\nREDDIT_CLIENT_ID REDDIT_CLIENT_SECRET REDDIT_USERNAME REDDIT_PASSWORD\n\n
\n\n\n\n\n\n**YouTube**\n\n\n\nChannels, playlists, videos, and categories via the YouTube Data API v3.\n\n\n\nYOUTUBE_ACCESS_TOKEN or YOUTUBE_API_KEY\n\n
\n\n\n\n\n\n**Facebook Pages**\n\n\n\nPosts, photos, comments, and Page insights via the Graph API.\n\n\n\n—\n\n
\n\n\n\n\n\n**LinkedIn**\n\n\n\nOrganic posts, timelines, reshares, and image uploads.\n\n\n\n—\n\n
\n\n\n\n\n\n**Pinterest**\n\n\n\nBoards, pins, and pin analytics via the Pinterest API v5.\n\n\n\n—\n\n
\n\n\n\n\n\n**Snapchat**\n\n\n\nAd accounts, campaigns, ads, and audience insights.\n\n\n\n—\n\n
\n\n\n\n\n\n**Tumblr**\n\n\n\nCreate, edit, and manage posts and blogs via the Tumblr API v2.\n\n\n\n—\n\n
\n\n\n\n\n\n**Twitter / X**\n\n\n\nPosts, search, timelines, profiles, and media uploads via the X API v2.\n\n\n\n—\n\n
📋 Project Mgmt (8)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Jira**\n\n\n\nIssues, comments, attachments, users, and workflows. Supports JQL search.\n\n\n\nJIRA_BASE_URL JIRA_API_TOKEN JIRA_EMAIL\n\n
\n\n\n\n\n\n**Notion**\n\n\n\nRead databases, create pages, and update blocks.\n\n\n\nNOTION_TOKEN\n\n
\n\n\n\n\n\n**Trello**\n\n\n\nManage boards, lists, and cards.\n\n\n\nTRELLO_API_KEY TRELLO_TOKEN\n\n
\n\n\n\n\n\n**Asana**\n\n\n\nManage tasks and projects.\n\n\n\nASANA_ACCESS_TOKEN\n\n
\n\n\n\n\n\n**Monday.com**\n\n\n\nUpdate items and manage boards.\n\n\n\nMONDAY_API_TOKEN\n\n
\n\n\n\n\n\n**ClickUp**\n\n\n\nManage tasks and workspaces.\n\n\n\nCLICKUP_API_TOKEN\n\n
\n\n\n\n\n\n**Todoist**\n\n\n\nManage personal and team to-dos.\n\n\n\nTODOIST_API_TOKEN\n\n
\n\n\n\n\n\n**Smartsheet**\n\n\n\nManage rows, columns, and sheets.\n\n\n\nSMARTSHEET_ACCESS_TOKEN\n\n
📊 Data (1)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Wikidata**\n\n\n\nSPARQL queries against the Wikidata knowledge base.\n\n\n\n—\n\n
📚 Knowledge (4)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Airtable**\n\n\n\nCRUD operations on bases and records.\n\n\n\nAIRTABLE_ACCESS_TOKEN\n\n
\n\n\n\n\n\n**Evernote**\n\n\n\nCreate and organize notes.\n\n\n\nEVERNOTE_TOKEN\n\n
\n\n\n\n\n\n**Obsidian**\n\n\n\nLocal vault management and markdown generation.\n\n\n\nOBSIDIAN_VAULT_PATH\n\n
\n\n\n\n\n\n**Google Sheets**\n\n\n\nRead, update, append, and clear spreadsheet data.\n\n\n\nGOOGLE_SHEETS_ACCESS_TOKEN\n\n
💼 CRM (7)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Salesforce**\n\n\n\nManage leads, contacts, and opportunities.\n\n\n\nSALESFORCE_INSTANCE_URL SALESFORCE_API_KEY\n\n
\n\n\n\n\n\n**HubSpot**\n\n\n\nInbound marketing and sales workflows.\n\n\n\nHUBSPOT_API_KEY\n\n
\n\n\n\n\n\n**Pipedrive**\n\n\n\nSales pipeline management.\n\n\n\nPIPEDRIVE_API_TOKEN\n\n
\n\n\n\n\n\n**Zoho CRM**\n\n\n\nLead and inventory management.\n\n\n\nZOHO_CRM_ACCESS_TOKEN\n\n
\n\n\n\n\n\n**Copper**\n\n\n\nCRM built for Google Workspace.\n\n\n\nCOPPER_API_KEY COPPER_USER_EMAIL\n\n
\n\n\n\n\n\n**Close**\n\n\n\nInside sales CRM.\n\n\n\nCLOSE_API_KEY\n\n
\n\n\n\n\n\n**Salesforce Pardot**\n\n\n\nB2B marketing automation.\n\n\n\nPARDOT_API_KEY PARDOT_BUSINESS_UNIT_ID\n\n
🎧 Support (3)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Zendesk**\n\n\n\nCustomer support ticket management.\n\n\n\nZENDESK_API_TOKEN ZENDESK_EMAIL ZENDESK_SUBDOMAIN\n\n
\n\n\n\n\n\n**Freshdesk**\n\n\n\nHelpdesk automation.\n\n\n\nFRESHDESK_API_KEY FRESHDESK_DOMAIN\n\n
\n\n\n\n\n\n**Intercom**\n\n\n\nIn-app messaging and customer data.\n\n\n\nINTERCOM_ACCESS_TOKEN\n\n
🛒 E-Commerce (11)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Shopify**\n\n\n\nProducts, orders, customers, and inventory via the Shopify Admin API.\n\n\n\n—\n\n
\n\n\n\n\n\n**Shopify Payments**\n\n\n\nOrders, transactions, payouts, balance, disputes, and refunds.\n\n\n\n—\n\n
\n\n\n\n\n\n**WooCommerce**\n\n\n\nProducts, orders, and customers.\n\n\n\nWOOCOMMERCE_STORE_URL WOOCOMMERCE_CONSUMER_KEY WOOCOMMERCE_CONSUMER_SECRET\n\n
\n\n\n\n\n\n**BigCommerce**\n\n\n\nProducts, orders, and customers.\n\n\n\nBIGCOMMERCE_STORE_HASH BIGCOMMERCE_ACCESS_TOKEN\n\n
\n\n\n\n\n\n**Magento**\n\n\n\nProducts, orders, and customers.\n\n\n\nMAGENTO_BASE_URL MAGENTO_ACCESS_TOKEN\n\n
\n\n\n\n\n\n**PrestaShop**\n\n\n\nProducts, orders, and customers.\n\n\n\nPRESTASHOP_STORE_URL PRESTASHOP_API_KEY\n\n
\n\n\n\n\n\n**Wix Stores**\n\n\n\nProducts, orders, and inventory.\n\n\n\nWIX_API_KEY WIX_SITE_ID\n\n
\n\n\n\n\n\n**Amazon Seller Central**\n\n\n\nSeller orders, catalog items, and FBA inventory.\n\n\n\nAMAZON_SPAPI_ACCESS_TOKEN AMAZON_SELLING_REGION\n\n
\n\n\n\n\n\n**eBay**\n\n\n\nSearch, seller inventory, and order management.\n\n\n\nEBAY_ACCESS_TOKEN\n\n
\n\n\n\n\n\n**Etsy**\n\n\n\nShops, listings, and receipts.\n\n\n\nETSY_API_KEY ETSY_ACCESS_TOKEN\n\n
\n\n\n\n\n\n**Gumroad**\n\n\n\nProducts, sales, and subscribers.\n\n\n\nGUMROAD_ACCESS_TOKEN\n\n
💳 Payments (9)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Stripe**\n\n\n\nCharges, refunds, invoices, subscriptions, and customers.\n\n\n\n—\n\n
\n\n\n\n\n\n**PayPal**\n\n\n\nOrders, captures, refunds, payouts, and balances.\n\n\n\n—\n\n
\n\n\n\n\n\n**Square**\n\n\n\nPayments, refunds, orders, subscriptions, and customers.\n\n\n\n—\n\n
\n\n\n\n\n\n**Braintree**\n\n\n\nTransactions, refunds, vault customers, and subscriptions.\n\n\n\n—\n\n
\n\n\n\n\n\n**Razorpay**\n\n\n\nOrders, payments, refunds, invoices, and subscriptions.\n\n\n\n—\n\n
\n\n\n\n\n\n**Wise**\n\n\n\nQuotes, recipients, transfers, and multi-currency balances.\n\n\n\n—\n\n
\n\n\n\n\n\n**QuickBooks**\n\n\n\nInvoices, customers, payments, sales receipts, and accounts.\n\n\n\n—\n\n
\n\n\n\n\n\n**FreshBooks**\n\n\n\nInvoices, clients, expenses, payments, and time entries.\n\n\n\n—\n\n
\n\n\n\n\n\n**Xero**\n\n\n\nInvoices, contacts, payments, accounts, and reports.\n\n\n\n—\n\n
☁️ Storage (10)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**AWS S3**\n\n\n\nBuckets, objects, ACLs, tags, and versions via S3 REST API.\n\n\n\n—\n\n
\n\n\n\n\n\n**Google Cloud Storage**\n\n\n\nBuckets, objects, metadata, and ACLs.\n\n\n\n—\n\n
\n\n\n\n\n\n**Google Drive**\n\n\n\nFiles, folders, permissions, and metadata.\n\n\n\n—\n\n
\n\n\n\n\n\n**Dropbox**\n\n\n\nFiles, folders, shared links, and metadata.\n\n\n\n—\n\n
\n\n\n\n\n\n**OneDrive**\n\n\n\nFiles, folders, sharing links, and drive metadata.\n\n\n\n—\n\n
\n\n\n\n\n\n**Box**\n\n\n\nFiles, folders, shared links, and metadata.\n\n\n\n—\n\n
\n\n\n\n\n\n**SharePoint**\n\n\n\nSites, document libraries, files, and sharing links.\n\n\n\n—\n\n
\n\n\n\n\n\n**Nextcloud**\n\n\n\nFiles and shares via WebDAV and OCS Share API.\n\n\n\n—\n\n
\n\n\n\n\n\n**MediaFire**\n\n\n\nFiles and folders via the MediaFire Core API 1.5.\n\n\n\n—\n\n
\n\n\n\n\n\n**FTP/SFTP**\n\n\n\nFile transfers, directory management, and remote metadata.\n\n\n\n—\n\n
📊 Analytics (10)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Google Analytics**\n\n\n\nReports, realtime metrics, properties, and metadata via GA4.\n\n\n\n—\n\n
\n\n\n\n\n\n**Amplitude**\n\n\n\nSegmentation, analytics queries, and event tracking.\n\n\n\n—\n\n
\n\n\n\n\n\n**Mixpanel**\n\n\n\nQuery, export, and send events.\n\n\n\n—\n\n
\n\n\n\n\n\n**Segment**\n\n\n\nSources, destinations, tracking plans, and events.\n\n\n\n—\n\n
\n\n\n\n\n\n**BigQuery**\n\n\n\nQuery datasets and tables in Google BigQuery.\n\n\n\n—\n\n
\n\n\n\n\n\n**Power BI**\n\n\n\nWorkspaces, reports, datasets, and dashboards.\n\n\n\n—\n\n
\n\n\n\n\n\n**Tableau**\n\n\n\nSites, workbooks, views, and data sources.\n\n\n\n—\n\n
\n\n\n\n\n\n**Snowflake**\n\n\n\nRun queries and inspect databases.\n\n\n\n—\n\n
\n\n\n\n\n\n**Databricks**\n\n\n\nRun SQL, manage jobs, and clusters.\n\n\n\n—\n\n
\n\n\n\n\n\n**PostgreSQL**\n\n\n\nQuery and manage a PostgreSQL database directly.\n\n\n\n—\n\n
👥 HR (10)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**BambooHR**\n\n\n\nEmployee directory, time-off, and applicant tracking.\n\n\n\n—\n\n
\n\n\n\n\n\n**Greenhouse**\n\n\n\nCandidates, applications, jobs, and pipeline management.\n\n\n\n—\n\n
\n\n\n\n\n\n**Lever**\n\n\n\nOpportunities, postings, applications, and pipeline stages.\n\n\n\n—\n\n
\n\n\n\n\n\n**Workable**\n\n\n\nJobs, candidates, pipeline stages, and employees.\n\n\n\n—\n\n
\n\n\n\n\n\n**Workday**\n\n\n\nWorkers, organizations, positions, and time tracking.\n\n\n\n—\n\n
\n\n\n\n\n\n**ADP**\n\n\n\nWorkers, pay statements, profiles, and payroll instructions.\n\n\n\n—\n\n
\n\n\n\n\n\n**Gusto**\n\n\n\nEmployees, jobs, payrolls, and pay stubs.\n\n\n\n—\n\n
\n\n\n\n\n\n**Rippling**\n\n\n\nEmployees, departments, teams, and leave requests.\n\n\n\n—\n\n
\n\n\n\n\n\n**Deel**\n\n\n\nContracts, payslips, payroll cycles, and employees.\n\n\n\n—\n\n
\n\n\n\n\n\n**SAP SuccessFactors**\n\n\n\nPersons, jobs, employment, and departments.\n\n\n\n—\n\n
🤖 AI/ML (10)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**OpenAI ChatGPT**\n\n\n\nChat, embeddings, and image generation with OpenAI.\n\n\n\nOPENAI_API_KEY\n\n
\n\n\n\n\n\n**Anthropic Claude**\n\n\n\nChat with Anthropic Claude models.\n\n\n\nANTHROPIC_API_KEY\n\n
\n\n\n\n\n\n**Google Gemini**\n\n\n\nGenerate content with Google Gemini models.\n\n\n\nGOOGLE_GEMINI_API_KEY\n\n
\n\n\n\n\n\n**Cohere**\n\n\n\nChat and embeddings with Cohere.\n\n\n\nCOHERE_API_KEY\n\n
\n\n\n\n\n\n**Hugging Face**\n\n\n\nRun inference and search models.\n\n\n\nHUGGINGFACE_API_TOKEN\n\n
\n\n\n\n\n\n**Replicate**\n\n\n\nRun open-source AI models on Replicate.\n\n\n\nREPLICATE_API_TOKEN\n\n
\n\n\n\n\n\n**Midjourney**\n\n\n\nGenerate images with Midjourney.\n\n\n\nMIDJOURNEY_BASE_URL MIDJOURNEY_API_KEY\n\n
\n\n\n\n\n\n**ElevenLabs**\n\n\n\nText-to-speech with ElevenLabs voices.\n\n\n\nELEVENLABS_API_KEY\n\n
\n\n\n\n\n\n**LangChain**\n\n\n\nInvoke deployed LangChain chains.\n\n\n\nLANGCHAIN_API_BASE_URL\n\n
\n\n\n\n\n\n**Pinecone**\n\n\n\nQuery and upsert vectors in Pinecone indexes.\n\n\n\nPINECONE_API_KEY\n\n
🛠️ Utilities (3)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Browser**\n\n\n\nStealth Chromium browser for web automation, scraping, and screenshots.\n\n\n\n—\n\n
\n\n\n\n\n\n**HTTP**\n\n\n\nHTTP requests to external APIs and web services.\n\n\n\n—\n\n
\n\n\n\n\n\n**Image**\n\n\n\nImage processing and manipulation with sharp.\n\n\n\n—\n\n
💻 Coding (20)
\n\n---\n\n\n\n**Agent**\n\n\n\n**Description**\n\n\n\n**Env Vars**\n\n
\n\n\n\n\n\n**Image to HTML**\n\n\n\nTransforms a UI image into a single self-contained HTML file with embedded CSS.\n\n\n\n—\n\n
\n\n\n\n\n\n**Image to React**\n\n\n\nTransforms a UI image into a React component.\n\n\n\n—\n\n
\n\n\n\n\n\n**JavaScript to TypeScript**\n\n\n\nConvert JavaScript source files into idiomatic TypeScript.\n\n\n\n—\n\n
\n\n\n\n\n\n**TypeScript to JavaScript**\n\n\n\nStrip TypeScript annotations and produce plain JavaScript.\n\n\n\n—\n\n
\n\n\n\n\n\n**React to Vue 2**\n\n\n\nConvert React components into Vue 2 Options API components.\n\n\n\n—\n\n
\n\n\n\n\n\n**Vue 2 to React**\n\n\n\nConvert Vue 2 Options API components into React functional components.\n\n\n\n—\n\n
\n\n\n\n\n\n**React to Vue 3**\n\n\n\nConvert React components into Vue 3 Composition API components.\n\n\n\n—\n\n
\n\n\n\n\n\n**Vue 3 to React**\n\n\n\nConvert Vue 3 Composition API components into React functional components.\n\n\n\n—\n\n
\n\n\n\n\n\n**React to Svelte**\n\n\n\nConvert React components into Svelte components.\n\n\n\n—\n\n
\n\n\n\n\n\n**Svelte to React**\n\n\n\nConvert Svelte components into React functional components.\n\n\n\n—\n\n
\n\n\n\n\n\n**CSS to SCSS**\n\n\n\nConvert plain CSS into structured SCSS with nesting and variables.\n\n\n\n—\n\n
\n\n\n\n\n\n**SCSS to CSS**\n\n\n\nFlatten SCSS files into plain, browser-ready CSS.\n\n\n\n—\n\n
\n\n\n\n\n\n**Comments Remover**\n\n\n\nStrip comments from source code while preserving functionality.\n\n\n\n—\n\n
\n\n\n\n\n\n**TypeScript Unused Code Remover**\n\n\n\nRemove unused imports, variables, functions, and types from TypeScript files.\n\n\n\n—\n\n
\n\n\n\n\n\n**JSON to YAML**\n\n\n\nConvert JSON files into clean YAML.\n\n\n\n—\n\n
\n\n\n\n\n\n**YAML to JSON**\n\n\n\nConvert YAML files into formatted JSON.\n\n\n\n—\n\n
\n\n\n\n\n\n**HTML to Pug**\n\n\n\nConvert HTML files into indented Pug templates.\n\n\n\n—\n\n
\n\n\n\n\n\n**Pug to HTML**\n\n\n\nExpand Pug templates into standard HTML markup.\n\n\n\n—\n\n
\n\n\n\n\n\n**JavaScript to Python**\n\n\n\nTranslate JavaScript source code into Python.\n\n\n\n—\n\n
\n\n\n\n\n\n**Python to JavaScript**\n\n\n\nTranslate Python source code into JavaScript.\n\n\n\n—\n\n
\n\n## Architecture\n\n```mermaid\ngraph TD\n User[\"User / Application\"] -->|prompt | NodeAgent[\"NodeAgent (Core Engine)\"]\n\n subgraph Core [\"NodeAgent Core\"]\n NodeAgent -->|1. Build messages | PromptBuilder[\"Prompt & System Context\"]\n NodeAgent -->|2. Dispatch request | Provider[\"LLM Engine (Ollama Local / Cloud)\"]\n Provider -->|3. Return completion | Parser[\"Output & JSON Parser\"]\n Parser -->|4. Detect hallucination & validate | Guardrails[\"Guardrails & Schema Validator\"]\n end\n\n Guardrails -->|5a. Tool call detected | Dispatcher[\"Tool Dispatcher\"]\n Guardrails -->|5b. Final response | Output[\"Final Output\"]\n\n subgraph Ecosystem [\"Tools & Agent Factories\"]\n Dispatcher -->|Execute | AgentFactories[\"Agent Factories (e.g. createGitHubAgent, createSlackAgent)\"]\n AgentFactories -->|Uses | Tools[\"Toolsets (gitTools, fsTools, shellTools, etc.)\"]\n end\n\n Tools -->|Result | NodeAgent\n```\n\n- **NodeAgent** — The core class. Manages the conversation loop, tool dispatch, hallucination detection, and JSON output parsing powered by Ollama. (OpenAI, Anthropic, and Gemini integrations are supported via dedicated toolsets.)\n- **Tool** — A typed function wrapper with name, metadata (description + JSON schema), and an async execution function.\n- **Agent factories** — Functions like `createGitHubAgent()` that wire up the right tools and system prompt for a specific domain.\n\n## Installation\n\n```bash\nnpm install n-agents\n```\n\n### Environment Setup\n\nCreate a `.env` file in your project root and choose one of the following configurations:\n\n#### Local Setup\n\n```bash\n# Required — Local model (gemma4:e2b-mlx for macOS, gemma4:e2b for Windows & Linux)\nOLLAMA_LOCAL_MODEL=gemma4:e2b-mlx\n\n# Optional — Local host override (defaults to http://localhost:11434)\n# OLLAMA_LOCAL_HOST=http://localhost:11434\n```\n\n#### Cloud Setup\n\n```bash\n# Required — Ollama Cloud API key and cloud model\nOLLAMA_API_KEY=your_api_key\nOLLAMA_CLOUD_MODEL=gemma4:cloud\n\n# Optional — Cloud host override (defaults to https://ollama.com)\n# OLLAMA_CLOUD_HOST=https://ollama.com\n```\n\n## Quick Start\n\n### Using a pre-built agent\n\n```typescript\nimport { createWikidataAgent } from \"n-agents\";\n\nconst agent = createWikidataAgent();\n\nconst result = await agent.execute({\n instructions: [\"List the top 5 largest countries by area.\"],\n onStep: (step) => console.log(`[Tool] ${step.tool}`),\n});\n\nconsole.dir(result.output, { depth: null });\n```\n\n### Creating a custom agent\n\n```typescript\nimport { NodeAgent, Tool } from \"n-agents\";\n\nconst greetTool = new Tool(\n \"greet\",\n async (_ctx, args) => ({ message: `Hello, ${args.name}!` }),\n {\n description: \"Greet someone by name\",\n schema: {\n type: \"object\",\n properties: {\n name: { type: \"string\", description: \"Name to greet\" },\n },\n required: [\"name\"],\n },\n },\n);\n\nconst agent = new NodeAgent({\n name: \"greeter\",\n description: \"A friendly greeting agent.\",\n tools: [greetTool],\n});\n\nconst result = await agent.execute({\n instructions: [\"Greet Alice\"],\n});\n\nconsole.log(result.output);\n// { summary: \"Greeted Alice\", data: { message: \"Hello, Alice!\" }, success: true }\n```\n\n## API Reference\n\n### NodeAgent\n\n```typescript\nconst agent = new NodeAgent(config: AgentConfig);\n\ninterface AgentConfig {\n name: string; // Agent identifier\n description?: string; // What this agent specializes in\n tools: Tool[]; // Array of tools the agent can call\n model?: string; // Ollama model override\n systemPrompt?: string; // Custom system prompt (overrides auto-generated)\n maxIterations?: number; // Max LLM turns (default: 50)\n projectRoot?: string; // Working directory for tools (default: \".\")\n rateLimitMs?: number; // Min delay between LLM calls (default: 500)\n}\n```\n\n### agent.execute()\n\n```typescript\nconst result = await agent.execute({\n instructions: string[], // Natural language task\n onStep?: (step: StepResult) => void, // Callback after each tool call\n stopOnStepFail?: boolean, // Abort on first tool failure (default: false)\n debug?: boolean; // Enable debug logging & verbose mode for tools (default: false)\n});\n\ninterface AgentResult {\n success: boolean; // Whether the task completed successfully\n output: R; // Parsed JSON output from the agent\n steps: StepResult[]; // Full log of every tool call\n iterations: number; // Number of LLM turns used\n durationMs: number; // Total wall-clock time\n error?: string; // Error message if success is false\n}\n\ninterface StepResult {\n tool: string; // Tool name that was called\n args: Record; // Arguments passed to the tool\n result: unknown; // Tool return value\n success: boolean; // Whether the tool call succeeded\n durationMs: number; // Tool execution time\n}\n```\n\n### Tool\n\n```typescript\nconst tool = new Tool(name: string, fn: ToolFn, metadata: ToolMetadata);\n\ntype ToolFn = (ctx: ToolContext, args: Record) => Promise;\n\ninterface ToolMetadata {\n description: string; // Shown to the LLM\n schema: ToolSchema; // JSON Schema for arguments\n}\n\ninterface ToolContext {\n projectRoot: string; // Resolved working directory\n env: Record; // Process environment\n}\n```\n\n## Customizing Agents\n\nEvery factory function accepts a partial override object, so you can tune any agent without forking:\n\n```typescript\nimport { createGitHubAgent } from \"n-agents\";\n\nconst agent = createGitHubAgent({\n maxIterations: 100, // Allow more turns for complex tasks\n rateLimitMs: 1000, // Slower rate limit\n projectRoot: \"/my/repo\", // Custom working directory\n});\n```\n\n## Error Handling\n\nThe library exports three error classes for typed error handling:\n\n```typescript\nimport { AgentError, ToolExecutionError, ConfigurationError } from \"n-agents\";\n\n// AgentError — Base class for all agent errors\n// ToolExecutionError — Thrown when a tool call fails (includes .toolName)\n// ConfigurationError — Thrown for missing API keys or invalid config\n```\n\n## Running Examples\n\nRun the included examples with:\n\n```bash\n# Query Wikidata for the top 5 largest countries\nnpm run example:wikidata\n\n# Scrape the top 10 Hacker News stories with the stealth browser\nnpm run example:browser\n```\n\n## Project Structure\n\n```text\nn-agents/\n├── agent.ts # NodeAgent core — conversation loop, tool dispatch, LLM integration\n├── tool.ts # Tool class — wraps typed functions for LLM consumption\n├── types.ts # Shared TypeScript interfaces (AgentConfig, AgentResult, etc.)\n├── errors.ts # Custom error classes (AgentError, ToolExecutionError, ConfigurationError)\n├── index.ts # Public API — re-exports all agents, tools, types, and errors\n├── agents/ # Agent factory functions (one per service)\n│ ├── github.ts\n│ ├── gitlab.ts\n│ ├── bitbucket.ts\n│ ├── git.ts\n│ ├── data/\n│ │ └── wikidata.ts\n│ ├── reddit.ts\n│ ├── youtube.ts\n│ ├── gmail.ts\n│ ├── slack.ts\n│ ├── jira.ts\n│ ├── instagram.ts\n│ ├── tiktok.ts\n│ ├── browser.ts\n│ ├── http.ts\n│ ├── google-sheets.ts\n│ └── index.ts # AGENTS_DEF — registry of all instantiated agents\n├── tools/ # Tool implementations (one per service + utilities)\n│ ├── github.ts # 93K — comprehensive GitHub API coverage\n│ ├── browser.ts # 69K — stealth Puppeteer automation\n│ ├── slack.ts # 41K — full Slack API integration\n│ ├── youtube.ts # 35K — YouTube Data API v3\n│ ├── jira.ts # 32K — Jira REST API\n│ ├── gmail.ts # 27K — Gmail API\n│ ├── reddit.ts # 24K — Reddit API\n│ ├── bitbucket.ts # 22K — Bitbucket API\n│ ├── gitlab.ts # 20K — GitLab API\n│ ├── git.ts # 17K — local git operations\n│ ├── data/\n│ │ └── wikidata.ts # 8K — SPARQL + entity search\n│ ├── instagram.ts # 5K — Instagram Graph API\n│ ├── tiktok.ts # 5K — TikTok Open API\n│ ├── fs.ts # 4K — filesystem operations\n│ ├── shell.ts # 2K — shell command execution\n│ ├── http.ts # HTTP requests\n│ ├── google-sheets.ts # Google Sheets API\n│ └── index.ts # Tool set re-exports\n├── utils/\n│ └── stealth-browser.ts # 43K — Puppeteer stealth setup with ghost-cursor\n├── examples/\n│ ├── wikidata.ts # Query Wikidata with natural language\n│ └── browser.ts # Scrape Hacker News top stories\n└── scripts/ # Utility scripts\n```\n\n---\n\n## Contributing\n\nContributions are welcome! If you'd like to add a new agent, improve an existing tool, or fix a bug, please open an issue or pull request on GitHub.\n\n## Sponsors\n\nThis project is made possible by the support of our sponsors.\n\n\n
\n\nName\n\n
\n\nYour logo here\n\n
\n\n## License\n\nn-agents is released under the MIT License\n\n---\n\n

Built with Ollama · TypeScript · Puppeteer

\n","readmeFilename":"README.md"}