Description

🚀 n8n-nodes-latitude 🚀

Stop hardcoding AI prompts. Start shipping smarter workflows.

The ultimate n8n integration for Latitude.so — the AI prompt management platform. Execute prompts, continue conversations, and log everything with zero JSON wrestling.

  •  

n8n-nodes-latitude is the prompt manager your n8n workflows wish they had. Stop embedding AI prompts directly in your automation and praying they still work next week. This node connects directly to Latitude.so, letting you manage prompts centrally, hot-reload changes, and execute with auto-detected parameters — all without touching your workflow.

How it slaps:

• You: Drag Latitude node into n8n workflow
• Node: Fetches prompts, shows parameters, handles auth
• You: Map your data → Execute
• Latitude: Returns response with usage stats, costs, and conversation UUID
• Result: Ship production AI features. Zero prompt maintenance headaches.

💥 Why This Slaps Hardcoded Prompts

Embedding prompts in workflows is a vibe-killer. n8n-nodes-latitude makes hardcoding look ancient.

We're not just calling an API. We're giving you centralized prompt management with dynamic parameter extraction, conversation continuity, and automatic SDK integration that handles all the complexity.

🚀 Get Started in 60 Seconds

Community Nodes (Recommended)

The fastest way to get started. No terminal required.

1. Go to Settings → Community Nodes
2. Click Install
3. Enter n8n-nodes-latitude
4. Confirm installation

That's it. The node appears in your node palette.

Manual Installation

For self-hosted n8n or custom setups:

# Navigate to your n8n installation
cd ~/.n8n/nodes

# Install the package
npm install n8n-nodes-latitude

# Restart n8n

✨ Zero Config: After installation, add your Latitude credentials and start building. The node handles SDK initialization, auth, and API versioning automatically.

✨ Feature Breakdown: The Secret Sauce

🎮 Operations Reference

Run Prompt ▶️

Execute an AI prompt from your Latitude project with automatic parameter detection.

Example Configuration:

Prompt Path: "marketing/personalized-email"
Parameters:
  - customer_name: {{ $json.name }}
  - product: {{ $json.product }}
  - tone: "professional"

Simplified Output:

{
  "uuid": "conv_abc123-def456",
  "text": "Dear John, thank you for your interest in...",
  "usage": {
    "promptTokens": 150,
    "completionTokens": 200,
    "totalTokens": 350
  },
  "cost": 0.0035
}

Chat 💬

Continue a conversation using the UUID from a previous prompt run.

Example — Building a Chatbot:

// First node: Run Prompt (initial)
// Returns: { uuid: "conv_abc123", text: "How can I help?" }

// Second node: Chat (continue)
Conversation UUID: {{ $('Latitude').item.json.uuid }}
Messages:
  - Role: user
    Content: "What's the weather like?"

Create Log 📝

Log conversations from external AI calls (OpenAI, Anthropic, etc.) to your Latitude project for unified analytics.

Use Case: You're calling OpenAI directly but want all your AI usage visible in Latitude's dashboard:

Prompt Path: "support/ticket-classifier"
Messages:
  - Role: user
    Content: {{ $json.ticket_body }}
Response: {{ $json.openai_response }}

⚙️ Credentials Setup

You need a Latitude.so account with API access.

Setting Up Credentials

1. Go to Credentials in n8n
2. Click New Credential
3. Search for Latitude API
4. Fill in your API Key and Project ID
5. (Optional) Add Gateway URL for self-hosted instances
6. Click Save — Credentials are automatically validated

🔒 Security Note: Your API key is encrypted at rest and never exposed in logs or error messages.

🔥 Workflow Examples

Basic: Webhook → AI Response

Webhook → Latitude (Run Prompt) → Respond to Webhook

Perfect for: Slack bots, API endpoints, form processing.

Advanced: Multi-Turn Chatbot

Webhook → Latitude (Run) → Set UUID → Loop → Latitude (Chat) → Respond

Perfect for: Customer support bots, interactive assistants.

Hybrid: External AI + Latitude Logging

Webhook → OpenAI → Latitude (Create Log) → Respond

Perfect for: Using other providers but want Latitude's analytics.

AI Agent Integration

AI Agent → Latitude Tool → Agent Output

Perfect for: ReAct agents, function calling, tool use.

🔧 Compatibility

🔥 Common Issues & Quick Fixes

🛠️ Development

Want to contribute or customize?

# Clone the repo
git clone https://github.com/yigitkonur/n8n-nodes-latitude.git
cd n8n-nodes-latitude

# Install dependencies
npm install

# Development mode (watch for changes)
npm run dev

# Build for production
npm run build

# Lint and format
npm run lint:fix
npm run format

Project Structure

├── credentials/          # Latitude API credential definition
├── nodes/Latitude/
│   ├── actions/          # Operation implementations
│   │   ├── runPrompt.operation.ts
│   │   ├── chat.operation.ts
│   │   └── createLog.operation.ts
│   ├── methods/          # Dynamic dropdown loaders
│   ├── shared/           # Types, utils, transport
│   └── Latitude.node.ts  # Main node definition
└── icons/                # Light/dark mode icons

📚 Resources

• Latitude Documentation — Full platform docs
• Latitude API Reference — API details
• n8n Community Nodes — How community nodes work
• Changelog — Version history and updates

🤝 Contributing

Contributions are welcome! This is how we make it better together.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request