{"id":28603123,"url":"https://github.com/resetnetwork/n8n-nodes","last_synced_at":"2025-06-11T17:01:56.146Z","repository":{"id":296945048,"uuid":"995097119","full_name":"ResetNetwork/n8n-nodes","owner":"ResetNetwork","description":"A collection of custom n8n nodes for enhanced document processing, text splitting, and embeddings generation","archived":false,"fork":false,"pushed_at":"2025-06-03T14:12:36.000Z","size":215,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-03T14:46:21.673Z","etag":null,"topics":["ai","document-processing","embeddings","langchain","monorepo","n8n","n8n-community-nodes","text-splitting","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/ResetNetwork/n8n-nodes","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ResetNetwork.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"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}},"created_at":"2025-06-03T00:58:02.000Z","updated_at":"2025-06-03T14:12:37.000Z","dependencies_parsed_at":"2025-06-03T14:46:34.918Z","dependency_job_id":"bcfb7d77-59ba-4afc-83de-48835df978f9","html_url":"https://github.com/ResetNetwork/n8n-nodes","commit_stats":null,"previous_names":["resetnetwork/n8n-nodes"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ResetNetwork/n8n-nodes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ResetNetwork%2Fn8n-nodes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ResetNetwork%2Fn8n-nodes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ResetNetwork%2Fn8n-nodes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ResetNetwork%2Fn8n-nodes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ResetNetwork","download_url":"https://codeload.github.com/ResetNetwork/n8n-nodes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ResetNetwork%2Fn8n-nodes/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259301537,"owners_count":22836950,"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","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":["ai","document-processing","embeddings","langchain","monorepo","n8n","n8n-community-nodes","text-splitting","typescript"],"created_at":"2025-06-11T17:00:36.150Z","updated_at":"2025-06-11T17:01:56.139Z","avatar_url":"https://github.com/ResetNetwork.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# n8n Custom Nodes Collection\n\nThis repository contains a collection of custom n8n nodes for enhanced document processing, text splitting, and embeddings generation, maintained by [Reset Network](https://github.com/ResetNetwork).\n\n## 📦 Available Packages\n\nAll packages are published to npm under the `@resetnetwork` scope and can be installed individually:\n\n| Package | Version | Description |\n|---------|---------|-------------|\n| [`n8n-nodes-contextual-document-loader`](./n8n-nodes-contextual-document-loader) | ![npm](https://img.shields.io/npm/v/n8n-nodes-contextual-document-loader) | ⚠️ **DEPRECATED** - Use `n8n-nodes-semantic-splitter-with-context` instead |\n| [`n8n-nodes-semantic-splitter-with-context`](./n8n-nodes-semantic-splitter-with-context) | ![npm](https://img.shields.io/npm/v/n8n-nodes-semantic-splitter-with-context) | Semantic text splitter with contextual information for enhanced document processing |\n| [`n8n-nodes-google-gemini-embeddings-extended`](./n8n-nodes-google-gemini-embeddings-extended) | ![npm](https://img.shields.io/npm/v/n8n-nodes-google-gemini-embeddings-extended) | Google Gemini Embeddings with extended features like output dimensions support |\n| [`n8n-nodes-google-vertex-embeddings-extended`](./n8n-nodes-google-vertex-embeddings-extended) | ![npm](https://img.shields.io/npm/v/n8n-nodes-google-vertex-embeddings-extended) | Google Vertex AI Embeddings with output dimensions and configurable batch size support |\n| [`n8n-nodes-query-retriever-rerank`](./n8n-nodes-query-retriever-rerank) | ![npm](https://img.shields.io/npm/v/n8n-nodes-query-retriever-rerank) | Advanced query retrieval with multi-step reasoning, reranking, and comprehensive debugging |\n\n## 🚀 Quick Start\n\n### Installing Individual Packages\n\nEach node can be installed individually via npm:\n\n```bash\n# Install a specific node\nnpm install n8n-nodes-semantic-splitter-with-context\n\n# Or install multiple nodes\nnpm install n8n-nodes-semantic-splitter-with-context n8n-nodes-google-gemini-embeddings-extended n8n-nodes-query-retriever-rerank\n```\n\n### Development Setup\n\nFor local development and testing:\n\n```bash\n# Clone the repository\ngit clone https://github.com/ResetNetwork/n8n-nodes.git\ncd n8n-nodes\n\n# Install dependencies for all packages\nnpm install\n\n# Build all packages\nnpm run build\n\n# Set up local development environment\n./setup-local.sh\n\n# Start n8n\n./start-n8n.sh\n```\n\n## 🛠️ Development\n\nThis repository uses npm workspaces to manage multiple packages. Here are the available commands:\n\n### Root Level Commands\n\n```bash\n# Install dependencies for all packages\nnpm install\n\n# Build all packages\nnpm run build\n\n# Run linting on all packages\nnpm run lint\n\n# Fix linting issues in all packages\nnpm run lintfix\n\n# Format code in all packages\nnpm run format\n\n# Run development mode for all packages\nnpm run dev\n\n# Publish all packages to npm (requires proper permissions)\nnpm run publish-all\n```\n\n### Helper Scripts\n\n- **`./setup-local.sh`** - Automatically builds and links all nodes for local testing\n- **`./start-n8n.sh`** - Starts n8n with pre-flight checks\n- **`./dev-watch.sh`** - Runs all nodes in watch mode for development\n- **`./cleanup-local.sh`** - Removes all node links when you're done\n\n### Working with Individual Packages\n\nYou can also work with individual packages:\n\n```bash\n# Work on a specific package\ncd n8n-nodes-semantic-splitter-with-context\n\n# Install dependencies for this package only\nnpm install\n\n# Build this package only\nnpm run build\n\n# Run in development mode\nnpm run dev\n```\n\n## 📋 Prerequisites\n\n- Node.js (version 18 or above)\n- npm (version 8 or above)\n- n8n installed globally or locally\n\n## 🔧 Local Development Setup\n\n### Quick Setup with Helper Scripts\n\n```bash\n# Clone and setup\ngit clone https://github.com/ResetNetwork/n8n-nodes.git\ncd n8n-nodes\n\n# Run the setup script\n./setup-local.sh\n\n# Start n8n\n./start-n8n.sh\n```\n\nFor development with auto-reload:\n```bash\n# In one terminal, run the watchers\n./dev-watch.sh\n\n# In another terminal, start n8n\n./start-n8n.sh\n```\n\n### Manual Setup\n\nIf you prefer manual setup:\n\n1. **Install n8n globally** (if not already installed):\n   ```bash\n   npm install n8n -g\n   ```\n\n2. **Clone and prepare the repository**:\n   ```bash\n   git clone https://github.com/ResetNetwork/n8n-nodes.git\n   cd n8n-nodes\n   npm install\n   ```\n\n3. **Build all packages**:\n   ```bash\n   npm run build\n   ```\n\n4. **Link packages to n8n**:\n   ```bash\n   # Create the custom directory if it doesn't exist\n   mkdir -p ~/.n8n/custom\n   cd ~/.n8n/custom\n   npm init -y\n\n   # Link each package\n   npm link n8n-nodes-semantic-splitter-with-context\n   npm link n8n-nodes-google-gemini-embeddings-extended\n   npm link n8n-nodes-google-vertex-embeddings-extended\n   npm link n8n-nodes-query-retriever-rerank\n   ```\n\n5. **Start n8n**:\n   ```bash\n   n8n start\n   ```\n\n## 📦 Publishing to npm\n\n### Prerequisites for Publishing\n\n1. **npm Account**: You need an npm account with access to publish packages\n2. **Organization Access**: For publishing under an organization scope, you need appropriate permissions\n3. **Authentication**: Login to npm via `npm login`\n\n### Publishing Individual Packages\n\nTo publish a single package:\n\n```bash\ncd n8n-nodes-semantic-splitter-with-context\nnpm publish --access public\n```\n\n### Publishing All Packages\n\nTo publish all packages at once:\n\n```bash\nnpm run publish-all\n```\n\nThis will:\n- Build all packages\n- Run linting\n- Publish all packages with public access\n\n### Version Management\n\nBefore publishing, update the version in the package's `package.json`:\n\n```bash\ncd n8n-nodes-semantic-splitter-with-context\nnpm version patch  # or minor, major\n```\n\n## 🧪 Testing\n\n### Verify Installation\n\nAfter installation, verify the nodes appear in n8n:\n\n1. Open n8n in your browser (typically at http://localhost:5678)\n2. Search for the following nodes in the nodes panel:\n   - **Semantic Splitter with Context** (search for \"semantic splitter\")\n   - **Google Gemini Embeddings Extended** (search for \"gemini\")\n   - **Google Vertex Embeddings Extended** (search for \"vertex\")\n   - **Query Retriever with Rerank** (search for \"query retriever\" or \"rerank\")\n\n### Development Testing\n\nFor development testing, use the provided test script:\n\n```bash\n#!/bin/bash\n# test-nodes.sh\n\necho \"Building all nodes...\"\nnpm run build\n\necho \"Starting n8n...\"\nn8n start\n```\n\n## 🐛 Troubleshooting\n\n### Node not appearing in n8n\n\n1. Ensure the node is properly built (`npm run build`)\n2. Check that the node is linked correctly\n3. Restart n8n\n4. Check the n8n logs for any error messages\n\n### Custom directory doesn't exist\n\nIf `~/.n8n/custom` doesn't exist:\n\n```bash\nmkdir -p ~/.n8n/custom\ncd ~/.n8n/custom\nnpm init -y\n```\n\n### Permission issues\n\nIf you encounter permission issues:\n- Use `sudo` for global npm operations, or\n- Configure npm to use a different directory for global packages\n\n### Different custom extensions directory\n\nIf your n8n installation uses a different directory (set via `N8N_CUSTOM_EXTENSIONS`), use that directory instead of `~/.n8n/custom`.\n\n### ESM Module Errors\n\nIf you encounter \"Cannot use import statement outside a module\" errors:\n1. Clean node_modules and reinstall dependencies\n2. Ensure you're using compatible package versions\n3. Check that TypeScript target is set correctly (ES2019 or later)\n\n## 🤝 Contributing\n\nWe welcome contributions! Please follow these guidelines:\n\n1. **Fork the repository** and create a feature branch\n2. **Follow the existing code structure** and patterns\n3. **Run linting** before committing: `npm run lint`\n4. **Fix any linting issues**: `npm run lintfix`\n5. **Format code**: `npm run format`\n6. **Test your changes** thoroughly in a local n8n instance\n7. **Submit a pull request** with a clear description of your changes\n\n### Development Workflow\n\n1. Make your changes in the respective node's source files\n2. Run the build command: `npm run build`\n3. Test in n8n\n4. For active development, use watch mode: `npm run dev`\n\n## 📄 License\n\nMIT License - see individual package directories for specific license files.\n\n## 🔗 Links\n\n- [Reset Network](https://github.com/ResetNetwork)\n- [n8n Documentation](https://docs.n8n.io/)\n- [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/)\n\n## 📞 Support\n\n- **Issues**: [GitHub Issues](https://github.com/ResetNetwork/n8n-nodes/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/ResetNetwork/n8n-nodes/discussions)\n- **Documentation**: Check individual package README files for specific documentation ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresetnetwork%2Fn8n-nodes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fresetnetwork%2Fn8n-nodes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresetnetwork%2Fn8n-nodes/lists"}