{"id":31830703,"url":"https://github.com/langwatch/n8n-nodes","last_synced_at":"2025-10-11T21:22:36.441Z","repository":{"id":316612751,"uuid":"1020056166","full_name":"langwatch/n8n-nodes","owner":"langwatch","description":"Combine the power of n8n and the LangWatch platform to supercharge your workflows. Unlock LangWatch’s Prompt Management, Evaluations, Datasets, and full Observability to build, monitor, and optimise AI-driven automations.","archived":false,"fork":false,"pushed_at":"2025-09-25T15:17:52.000Z","size":126,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-25T17:28:50.589Z","etag":null,"topics":["llm-evaluation","llmops","n8n","n8n-community-nodes","n8n-nodes","observability","prompt-management"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/langwatch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-15T09:18:13.000Z","updated_at":"2025-09-25T15:24:47.000Z","dependencies_parsed_at":"2025-09-25T17:32:05.282Z","dependency_job_id":"7c3515d8-6791-4389-b2fe-695081e95d91","html_url":"https://github.com/langwatch/n8n-nodes","commit_stats":null,"previous_names":["langwatch/n8n-nodes"],"tags_count":1,"template":false,"template_full_name":"n8n-io/n8n-nodes-starter","purl":"pkg:github/langwatch/n8n-nodes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/langwatch%2Fn8n-nodes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/langwatch%2Fn8n-nodes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/langwatch%2Fn8n-nodes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/langwatch%2Fn8n-nodes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/langwatch","download_url":"https://codeload.github.com/langwatch/n8n-nodes/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/langwatch%2Fn8n-nodes/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279008847,"owners_count":26084516,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["llm-evaluation","llmops","n8n","n8n-community-nodes","n8n-nodes","observability","prompt-management"],"created_at":"2025-10-11T21:22:34.050Z","updated_at":"2025-10-11T21:22:36.431Z","avatar_url":"https://github.com/langwatch.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![LangWatch + n8n](./assets/cover.webp)\n\n# @langwatch/n8n-nodes-langwatch\n\nThis is an n8n community node. It lets you use [LangWatch](https://langwatch.ai) in your n8n workflows.\n\n[LangWatch](https://langwatch.ai) is an LLM observability platform that provides tracing, evaluation, datasets, and prompt management.\n\n[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.\n\n## 🚀 **Recommended: Pair with [Observability](https://github.com/langwatch/n8n-observability)**\n\nFor complete LangWatch integration, pair these nodes with `@langwatch/n8n-observability` to automatically trace your n8n workflows:\n\n![Observability Setup](./assets/observability.webp)\n\n**Quick setup for self-hosted n8n via npm:**\n```bash\nnpm install -g @langwatch/n8n-observability\nexport EXTERNAL_HOOK_FILES=$(node -e \"console.log(require.resolve('@langwatch/n8n-observability/hooks'))\")\nexport N8N_OTEL_SERVICE_NAME=my-n8n\nn8n start\n```\n\n## Table of Contents\n\n- [Installation](#installation)  \n- [Operations](#operations)  \n- [Credentials](#credentials)  \n- [Development](#development)  \n- [Resources](#resources)\n\n## Installation\n\n### Self-hosted n8n\nFollow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.\n\n```bash\nnpm install @langwatch/n8n-nodes-langwatch\n```\n\n### n8n Cloud\nThis is a verified community node. Search for `LangWatch` to use this node in n8n Cloud.\n\n## Operations\n\n### Dataset Batch Trigger\nEmit one item per dataset row sequentially until done. Optionally initializes an experiment context for batch evaluations.\n\n**Key parameters:**\n- Dataset Slug or ID\n- Experiment Configuration (enable, ID/Slug, Name, Workflow ID)\n- Row Processing Options: startRow, endRow, stepSize, limitRows/maxRows, shuffleRows/seed\n- Emit Interval (ms)\n\n**Output fields:**\n- `entry` (your dataset row payload)\n- `row_number`, `row_id`, `datasetId`, `projectId`, timestamps\n- `_progress` { current, total, percentage, remaining }\n- `_langwatch.dataset` { id, rowId, rowNumber }\n- `_langwatch.experiment` and `_langwatch.batch` when experiment is enabled\n\n### Dataset Row Trigger\nFetch a single dataset row per execution while maintaining an internal cursor. Great for stepwise or scheduled processing.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./assets/trigger-dataset-row.webp\" alt=\"Dataset Row Trigger node configuration interface\" style=\"max-width: 500px;\" /\u003e\n\u003c/div\u003e\n\n**Key parameters:**\n- Dataset Slug or ID\n- Row Processing Options: startRow, endRow, stepSize, limitRows/maxRows\n- Reset Progress, Shuffle Rows, Shuffle Seed\n\n### Evaluation\nRun evaluators and/or record results with multiple operation modes.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./assets/node-evaluation-auto.webp\" alt=\"Evaluation node configuration interface showing auto mode\" style=\"max-width: 500px;\" /\u003e\n\u003c/div\u003e\n\n**Operations:**\n- Auto (Recommended) - automatically selects behavior based on inputs\n- Check If Evaluating - determines if running in evaluation context\n- Record Result - log a pre-computed evaluation result\n- Run and Record - execute an evaluator and log results\n- Set Outputs (Dataset) - write entries back to a dataset\n\n**Key parameters:**\n- Run ID (optional override; otherwise inferred from `_langwatch.batch.runId`)\n- Evaluator selection (manual or dropdown)\n- Name, Evaluation Data, Evaluator Settings\n- Guardrail flags: `asGuardrail`, `failOnFail`\n- Dataset write: `datasetSlug`, `format` (standard/custom), mapping fields\n\n### Prompt\nRetrieve and optionally compile a prompt from LangWatch Prompt Manager.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./assets/node-prompt.webp\" alt=\"Prompt node configuration interface\" style=\"max-width: 500px;\" /\u003e\n\u003c/div\u003e\n\n**Key parameters:**\n- Prompt selection: Manual (handle/ID) or Dropdown\n- Version selection: Latest or Specific version\n- Compile Prompt: Off/On\n- Variable Source: Manual, From Input Data, or Mixed\n- Strict Compilation: fail if required variables are missing\n\n**Variables:**\n- Manual variables: list of name/value pairs (supports n8n expressions)\n- Input data variables: map template variable → input data path\n\n## Credentials\n\nTo use this node, you need to authenticate with LangWatch. You'll need:\n\n1. A LangWatch account at [app.langwatch.ai](https://app.langwatch.ai)\n2. API credentials from your LangWatch project settings: hostname and API key\n\n**How to create:**\n1. In n8n, open Settings → Credentials → New\n2. Pick \"LangWatch API\"\n3. Fill endpoint and API key → Save → Test\n\n## Development\n\n### Prerequisites\nYou need the following installed on your development machine:\n\n- [git](https://git-scm.com/downloads)\n- Node.js and npm. Minimum version Node 20. You can find instructions on how to install both using nvm (Node Version Manager) for Linux, Mac, and WSL [here](https://github.com/nvm-sh/nvm). For Windows users, refer to Microsoft's guide to [Install NodeJS on Windows](https://docs.microsoft.com/en-us/windows/dev-environment/javascript/nodejs-on-windows).\n- Install n8n with:\n  ```\n  npm install n8n -g\n  ```\n- Recommended: follow n8n's guide to [set up your development environment](https://docs.n8n.io/integrations/creating-nodes/build/node-development-environment/).\n\n### Build new version\n```bash\nnpm run build\nnpm link\n```\n\n### Test in local n8n\n```bash\ncd ~/.n8n/custom\nnpm link n8n-nodes-langwatch\n```\n\n## Resources\n\n- [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)\n- [LangWatch documentation](https://docs.langwatch.ai)\n- [LangWatch n8n integration](https://docs.langwatch.ai/integrations/n8n)\n- [LangWatch Datasets](https://docs.langwatch.ai/datasets/overview)\n- [LangWatch Prompts](https://docs.langwatch.ai/features/prompt-versioning#prompt-versioning)\n- [LangWatch n8n Observability](https://github.com/langwatch/n8n-observability) - for workflow instrumentation\n\n## License\n\n[MIT](./LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flangwatch%2Fn8n-nodes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flangwatch%2Fn8n-nodes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flangwatch%2Fn8n-nodes/lists"}