An open-source repository of n8n workflows that power Samantha, our evolving voice AI agent.

Samantha is a voice AI agent that we're building together as a community through monthly workshops. Each month, we add new skillsets and capabilities to make Samantha more intelligent, helpful, and versatile. This repository serves as the central hub for all n8n workflows that define Samantha's abilities.

We maintain flexibility in our voice layer by supporting both Vapi and 11Labs, ensuring Samantha can adapt to different voice requirements and use cases.

• n8n - Workflow automation platform that powers Samantha's logic and integrations
• Vapi - Primary voice interface that gives Samantha her voice and conversation abilities
• 11Labs - Alternative voice synthesis solution to keep the voice layer interchangeable
• Various APIs - Integrations that extend Samantha's capabilities

Our goal is to create the most comprehensive, community-driven voice AI agent by:

• Building new workflows monthly through workshops
• Encouraging community contributions of innovative skillsets
• Maintaining high-quality, well-documented workflows
• Creating a learning environment for n8n and voice AI enthusiasts

We host monthly workshops where participants learn to build new skills for Samantha:

• Date: July 26-27, 2024
• Registration: lu.ma/7lepjq0c
• Status: 175+ already registered!
• Topic: Building a complete mini voice CRM system for Samantha

samantha-n8n-workflows/
├── workflows/
│   ├── voice-crm-system/
│   │   ├── workflow.json    # n8n workflow file
│   │   └── readme.md        # Detailed workflow documentation
│   ├── email-automation/
│   │   ├── workflow.json
│   │   └── readme.md
│   ├── calendar-integration/
│   │   ├── workflow.json
│   │   └── readme.md
│   └── [skillset-name]/
│       ├── workflow.json    # Each skillset contains these files
│       └── readme.md        # Detailed explanation of the workflow
├── docs/                    # General documentation and guides
└── templates/               # Templates for new contributors

Each skillset should follow this structure:

• Folder naming: Use kebab-case (lowercase with hyphens) that clearly describes the skillset functionality, e.g., voice-crm-system, email-automation, calendar-integration
• workflow.json: The exported n8n workflow file that can be directly imported into any n8n instance
• readme.md: A comprehensive guide explaining the workflow's purpose, setup instructions, required credentials, configuration steps, and usage examples

This standardized structure ensures consistency across all contributions and makes it easy for users to understand and implement any skillset.

• n8n instance (local or cloud)
• Basic understanding of workflow automation
• Enthusiasm for voice AI development!

1. Clone this repository

git clone https://github.com/yourusername/samantha-n8n-workflows.git
cd samantha-n8n-workflows

2. Navigate to the specific skillset you want to use:

cd workflows/[skillset-name]

3. Import the workflow.json file into your n8n instance
4. Read the readme.md for detailed setup instructions
5. Configure necessary credentials and API keys as described
6. Test and customize the workflow for your use case

We welcome contributions from developers, automation enthusiasts, and anyone interested in advancing voice AI capabilities!

1. Fork this repository
2. Create a new branch for your feature/workflow
3. Develop your n8n workflow
4. Document your workflow thoroughly
5. Test your implementation
6. Submit a pull request

• Include clear documentation for each workflow
• Add example use cases and screenshots
• Ensure workflows are well-commented
• Test thoroughly before submitting (see testing procedures below)
• Follow the repository structure

1. Create a Vapi Assistant

   • Set up a new assistant in your Vapi dashboard
   • Configure basic voice settings and prompts

2. Create a Tool in Vapi

   • Add a new tool/function to your assistant
   • Configure the tool parameters as needed

3. Set up n8n Webhook

   • In your n8n workflow, ensure you have a webhook node
   • Copy the webhook URL from the n8n webhook node

4. Connect Vapi to n8n

   • Paste the n8n webhook URL into your Vapi tool configuration
   • Attach the tool to your assistant

5. End-to-End Testing

   • Test the complete workflow by calling your Vapi assistant
   • Verify that the voice interaction triggers the n8n workflow
   • Confirm the workflow executes successfully and returns expected results

6. Documentation & Submission

   • Record a screen recording showing the complete workflow in action
   • Include the recording link in your skillset's readme.md file
   • Submit the pull request with both the workflow and demonstration

1. Set up 11Labs Integration

   • Configure your 11Labs API credentials in n8n
   • Test voice synthesis functionality

2. End-to-End Testing

   • Test the complete workflow with 11Labs voice generation
   • Verify audio output quality and timing
   • Confirm proper integration with other workflow components

3. Documentation & Submission

   • Record a screen recording demonstrating the workflow
   • Include audio samples in your documentation
   • Submit with detailed setup instructions

Want to be more involved? Join our special contributor WhatsApp group for:

• Direct access to workshop creator Aemal Sayer (aemalsayer.com)
• Advanced n8n learning opportunities
• Early access to workshop content
• Collaborative development sessions
• Priority support and mentoring

• Voice CRM System (July 2024 Workshop)
• Communication Automation
• Data Processing & Analysis
• Integration Workflows
• Utility Functions

• Customer Support Automation
• E-commerce Integration
• Social Media Management
• Calendar & Scheduling
• File Processing & Management

Each skillset folder contains:

• workflow.json - The complete n8n workflow file ready for import
• readme.md - Detailed documentation including:
  • Purpose and use case description
  • Step-by-step setup and configuration guide
  • Required credentials and API keys
  • Input/output specifications
  • Example scenarios and use cases
  • Troubleshooting guide and common issues

• n8n Documentation
• Vapi Documentation
• Workshop recordings and materials
• Community tutorials and guides

Aemal Sayer - Workshop facilitator and project maintainer

• Website: aemalsayer.com
• Passionate about democratizing voice AI and automation

• Issues: Use GitHub Issues for bug reports and feature requests
• Discussions: Join GitHub Discussions for community chat
• Workshops: Attend monthly workshops for hands-on learning
• Direct Access: Join our contributor WhatsApp group (DM for invite)

This project is open source and available under the MIT License.

If you find this project helpful, please consider giving it a star ⭐ to help others discover it!

Together, let's build the most capable voice AI agent the community has ever seen! 🚀