This guide was tested with Flowise v2.x. If you’re using a different version, some UI paths or features may vary.
Prerequisites
- A SambaCloud account and API key.
- Node.js v18.15.0 or later.
Setup
-
Install Flowise.
-
Start Flowise.
-
Open your browser to
http://localhost:3000. You should see the Flowise dashboard with the Chatflows panel.
Usage
Create a chat flow
In the Chatflows panel, click Add New in the upper-right corner.
Add a SambaNova node
- In the left sidebar, expand the Chat Models category.
- Drag the ChatSambaNova node onto the canvas.

Configure SambaNova credentials
- Click the ChatSambaNova node on the canvas.
- In the Credential dropdown, select Create New.
- Enter your SambaCloud API key and click Save.
- Select a model from the Model Name dropdown.

Build your workflow
Connect additional nodes to create your workflow. Common configurations include:- Basic chat: Connect the ChatSambaNova node directly to a chat output.
- RAG pipeline: Add document loaders, vector stores, and retrieval chains.
- Agents: Combine with tool nodes for agentic workflows.
Test the chat
- Click the Chat icon in the upper-right corner of the canvas.
- Send a test message to verify the connection.

Capabilities
Once connected, you can use SambaCloud models in various Flowise workflows:- Conversational agents: Build chatbots with memory and context awareness.
- Document Q&A: Create RAG pipelines that ground responses in your documents.
- Tool-using agents: Connect external tools and APIs for agentic workflows.
- Custom chains: Design multi-step LLM pipelines with branching logic.
Troubleshooting
| Issue | Solution |
|---|---|
| ChatSambaNova node not appearing | Ensure you’re running Flowise v2.x or later. Restart Flowise after updating. |
| Authentication errors | Verify your API key is correct. Regenerate it in the SambaCloud console if needed. |
| Connection timeout | Check your network connection and ensure api.sambanova.ai is accessible. |
| Model not responding | Confirm you’ve selected a valid model from the dropdown and saved your credentials. |
