Contribute templates
Follow these best practices when submitting a template to Langflow.
For template formatting examples, see /starter_projects
in the Langflow repository.
Create a PR to submit your template
Follow these steps to submit your template:
- Fork the Langflow repository on GitHub.
- On your fork, add your
template.json
file to/starter_projects
. - Include the required items for template submission.
- Create a Pull Request (PR) from your fork to the main Langflow repository.
- Include a screenshot of your template in the PR.
The Langflow team will review your PR, offer feedback, and, if approved, merge the template.
Required items for template submission
Include the following items and follow these guidelines when submitting your template.
Name
The template name must be concise and contain no more than three words. Capitalize only the first letter of each word. For example: Blog Writer or Travel Planning Agent.
Description
A brief, informative description that is shown in the visual editor to help users understand the template's purpose and use cases. For example:
_10 "description": "Auto-generate a customized blog post from instructions and referenced articles.",
Icons
Use icons from the Lucide icon library.
Flow
Use only the components that are available in the Components menu in the visual editor. Don't use custom components.
Include brief README, quickstart, or other essential details in a note. Notes accept Markdown syntax. For example:
_17# Financial Assistant Agents_17_17The Financial Assistant Agent retrieves web content and writes reports about finance._17_17## Prerequisites_17_17* [OpenAI API key](https://platform.openai.com/api-keys)_17* [Tavily AI Search key](https://docs.tavily.com/welcome)_17* [Sambanova API key](https://sambanova.ai/)_17_17## Quickstart_17_171. In both **Agent** components, add your OpenAI API key._172. In the **Model Provider** field, select **Sambanova**, and select a model._173. In the **Sambanova** component, add your **Sambanova API key**._174. In the **Tavily Search** component, add your **Tavily API key**._175. Click the **Playground** and ask `Why did Nvidia stock drop in January?`
Format
Submit the template in JSON format.
Tags
Assign the template to one of the following categories:
- Assistants
- Classification
- Coding
- Content Generation
- Q&A
- Prompting
- RAG
- Agents
For more information, see the Langflow repository's template categories.