This commit is contained in:
Bentlybro
2025-01-12 12:23:46 +00:00
parent 13be1a03b7
commit 40961cb9f1
34 changed files with 0 additions and 1813 deletions

View File

@@ -1,49 +0,0 @@
# Agent Block Documentation
## Agent Executor
### What it is
A specialized block that allows one agent to execute another agent, enabling nested agent functionality within your automation workflows.
### What it does
This block takes an existing agent (identified by its graph information) and executes it as part of another agent's workflow. It manages the execution process, monitors the progress, and handles the output data produced by the executed agent.
### How it works
1. The block receives necessary identification and input data
2. It initiates the execution of the specified agent
3. Listens for events from the executed agent
4. Monitors the execution status and progress
5. Collects and processes any output produced
6. Returns the processed output data to the parent agent
### Inputs
- User ID: The identifier for the user running the agent
- Graph ID: The unique identifier for the agent (graph) to be executed
- Graph Version: The specific version of the agent to run
- Data: The input data that will be passed to the executed agent
- Input Schema: The structure definition for the input data
- Output Schema: The structure definition for the expected output data
### Outputs
This block has a dynamic output system that:
- Yields output data as it's produced by the executed agent
- Each output includes:
- Output Name: Identifier for the specific output
- Output Data: The actual data produced by the executed agent
### Possible use case
Imagine you have a main agent that handles customer service requests. Within this agent, you might want to execute a specialized agent that performs detailed product analysis. The Agent Executor block would allow your main agent to:
1. Receive a customer query
2. Execute the product analysis agent
3. Wait for and collect the analysis results
4. Use those results to provide a comprehensive response to the customer
The block handles all the complexity of managing this nested agent execution, making it appear seamless to the end user.
### Notes
- The block provides detailed logging of the execution process
- It can handle various execution statuses (completed, terminated, failed)
- It specifically processes output blocks from the executed agent
- The execution is monitored in real-time through an event bus system

View File

@@ -1,50 +0,0 @@
## AI Image Generator
### What it is
A versatile AI-powered image generation block that creates custom images based on text descriptions using various AI models and styles.
### What it does
Transforms text prompts into high-quality images with customizable formats, styles, and dimensions using different AI image generation models like Stable Diffusion, Flux, and Recraft.
### How it works
1. Takes a text prompt and image preferences from the user
2. Connects to the selected AI model through Replicate's API
3. Processes the request with appropriate sizing and styling
4. Returns a URL to the generated image or an error message if something goes wrong
### Inputs
- Credentials: Replicate API key required to access the image generation service
- Prompt: Text description of the image you want to generate (e.g., "A red panda using a laptop in a snowy forest")
- Model: Choice of AI model to use for generation:
- Stable Diffusion 3.5 Medium
- Flux 1.1 Pro
- Flux 1.1 Pro Ultra
- Recraft v3
- Image Format: Shape and dimensions of the output image:
- Square: For profile pictures and icons (1:1 ratio)
- Landscape: For traditional photos (4:3 ratio)
- Portrait: For vertical photos (3:4 ratio)
- Wide: For cinematic images (16:9 ratio)
- Tall: For mobile wallpapers (9:16 ratio)
- Image Style: Visual aesthetic for the generated image, including:
- Realistic styles (natural, studio, black & white, HDR)
- Digital art styles (pixel art, hand-drawn, sketch, poster)
- Various artistic variations (grain, engraving, outline)
### Outputs
- Image URL: Web address where the generated image can be accessed
- Error: Description of any problems encountered during image generation
### Possible use cases
1. Marketing team creating custom social media visuals
2. Designer generating concept art for presentations
3. Content creator making thumbnail images for articles
4. E-commerce platform creating product visualization
5. App developer generating placeholder images for prototypes
### Notes
- Image quality and style consistency may vary between different AI models
- Processing time depends on the selected model and image complexity
- Some styles may work better with specific models than others
- Generated images are temporarily hosted and accessible via URL

View File

@@ -1,51 +0,0 @@
## AI Music Generator
### What it is
A specialized block that generates music using Meta's MusicGen model through the Replicate platform, allowing users to create unique audio content based on text descriptions.
### What it does
Transforms text descriptions into original music pieces while allowing fine-tuned control over various aspects of the generation process, such as duration, audio quality, and musical characteristics.
### How it works
1. Takes a text prompt and various musical parameters as input
2. Connects to the Replicate platform using provided credentials
3. Processes the request using Meta's MusicGen model
4. Generates an audio file based on the specifications
5. Returns a URL where the generated audio can be accessed
6. Includes automatic retry mechanisms if the generation fails
### Inputs
- Credentials: Replicate API key required for accessing the service
- Prompt: Text description of the desired music (e.g., "An upbeat electronic dance track with heavy bass")
- Model Version: Choice of music generation model (Stereo Large, Melody Large, or Large)
- Duration: Length of the generated audio in seconds
- Temperature: Controls creativity level (higher values = more diverse output)
- Top K: Controls token sampling variety (higher values = more diverse possibilities)
- Top P: Alternative sampling method for controlling output variety
- Classifier Free Guidance: Controls how closely the output follows the input prompt
- Output Format: Choice between WAV or MP3 file formats
- Normalization Strategy: Method for adjusting audio levels (Loudness, Clip, Peak, or RMS)
### Outputs
- Result: URL link to the generated audio file
- Error: Error message if the generation process fails
### Possible use cases
- Creating background music for videos or podcasts
- Generating custom soundtracks for games or applications
- Producing music stems for remixing
- Creating unique audio content for multimedia installations
- Prototyping musical ideas for composers
- Generating ambient sound for installations or events
- Creating custom hold music for phone systems
- Producing demo tracks for presentations
### Additional Notes
- The block includes automatic retry functionality (up to 3 attempts) if generation fails
- Supports multiple audio output formats
- Provides various controls for fine-tuning the generated music
- Uses industry-standard normalization strategies for professional-quality output
- Integrates seamlessly with Meta's latest music generation technology
- Provides detailed control over the creative aspects of music generation

View File

@@ -1,50 +0,0 @@
## AI Shortform Video Creator
### What it is
A powerful tool that creates short-form videos using AI technology, combining visual elements, voice narration, and background music.
### What it does
This block transforms text scripts into engaging short-form videos by automatically generating visuals, adding AI voice narration, and incorporating background music. It supports various visual styles, aspect ratios, and customization options.
### How it works
1. Takes a script with special formatting where regular text is spoken and text in brackets guides visual generation
2. Creates a webhook to monitor the video creation process
3. Submits the video creation request with specified parameters
4. Monitors the creation process until completion
5. Returns the final video URL when ready
### Inputs
- Credentials: API key credentials for accessing the revid.ai service
- Script: Text content with special formatting where regular text is spoken and [bracketed text] guides visual generation
- Ratio: Video aspect ratio (default: "9/16" for vertical videos)
- Resolution: Video quality setting (default: "720p")
- Frame Rate: Video smoothness setting (default: 60 fps)
- Generation Preset: Visual style for AI-generated content, with options including:
- Default
- Anime
- Realism
- Illustration
- Sketch (Color and B&W)
- Pixar
- Japanese Ink
- 3D Render
- And many more styles
- Background Music: Choice of background track from a curated selection
- Voice: AI narrator voice selection (options include Lily, Daniel, Brian, Jessica, Charlotte, and Callum)
- Video Style: Type of visual media (Stock Videos, Moving AI Images, or AI Video)
### Outputs
- Video URL: Direct link to the completed video
- Error: Message explaining any issues that occurred during video creation
### Possible use cases
- Creating engaging social media content for platforms like TikTok or Instagram
- Producing educational content with AI-generated visuals and professional narration
- Making product demonstrations with custom visual styles
- Generating quick marketing videos with consistent branding
- Creating storytelling content with synchronized visuals and narration
- Producing automated news summaries with relevant visuals
### Note
The system is designed to be user-friendly while offering professional-grade video creation capabilities. Users can focus on their content while the AI handles the technical aspects of video production, including visual generation, voice synthesis, and audio-visual synchronization.

View File

@@ -1,146 +0,0 @@
# Basic Blocks Documentation
## Store Value
### What it is
A simple block that stores and forwards a value without modifying it.
### What it does
Takes an input value and makes it available for reuse multiple times without changing it.
### How it works
Stores either a provided constant value or the input value and outputs it whenever requested.
### Inputs
- Input: The value to be stored if no data is provided
- Data: A constant value to be stored (optional)
### Outputs
- Output: The stored value (either from data or input)
### Possible use case
When you need to reuse the same value multiple times in different parts of your workflow, like a configuration setting or a constant value.
## Print To Console
### What it is
A debugging tool that displays text in the console.
### What it does
Prints the provided text to the console for debugging purposes.
### How it works
Takes the input text and displays it in the console with a prefix ">>>>> Print: "
### Inputs
- Text: The message to be printed to the console
### Outputs
- Status: Confirmation that the text was printed ("printed")
### Possible use case
When debugging your workflow and need to see the value of variables or confirm that certain steps are being executed.
## Find In Dictionary
### What it is
A tool for looking up values in dictionaries, lists, or objects.
### What it does
Searches for a specified key in various data structures and returns the corresponding value.
### How it works
Examines the input data structure and attempts to find the requested key, returning either the found value or indicating that it's missing.
### Inputs
- Input: The data structure to search in (dictionary, list, or object)
- Key: The key or index to look up
### Outputs
- Output: The found value for the given key
- Missing: The input data if the key wasn't found
### Possible use case
When working with complex data structures and need to extract specific pieces of information.
## Agent Input
### What it is
A block for handling user input in workflows.
### What it does
Manages and processes input values with various options for customization.
### How it works
Takes a value along with metadata about how it should be handled and makes it available to the workflow.
### Inputs
- Name: Identifier for the input
- Value: The actual input value
- Title: Display title (optional)
- Description: Explanatory text (optional)
- Placeholder Values: Suggested values (optional)
- Limit to Placeholder Values: Restricts input to suggested values
- Advanced: Whether to show in advanced settings
- Secret: Whether to treat as sensitive information
### Outputs
- Result: The processed input value
### Possible use case
Creating a user interface where users need to provide information with specific constraints or guidance.
## Agent Output
### What it is
A block for formatting and displaying workflow results.
### What it does
Takes values and formats them for presentation as output.
### How it works
Processes the input value using optional formatting rules and prepares it for display.
### Inputs
- Value: The data to be output
- Name: Identifier for the output
- Title: Display title (optional)
- Description: Explanatory text (optional)
- Format: Template for formatting the output
- Advanced: Whether to treat as advanced output
- Secret: Whether to treat as sensitive information
### Outputs
- Output: The formatted result
### Possible use case
Creating formatted reports or displaying results in a specific way.
## Add To Dictionary
### What it is
A tool for adding new entries to dictionaries.
### What it does
Adds one or more key-value pairs to an existing or new dictionary.
### How it works
Takes a dictionary (or creates a new one) and adds specified entries to it.
### Inputs
- Dictionary: Existing dictionary to modify (optional)
- Key: New key to add
- Value: Value for the new key
- Entries: Multiple key-value pairs to add
### Outputs
- Updated Dictionary: The dictionary with new entries
- Error: Any error messages
### Possible use case
Building or modifying configuration settings or collecting data incrementally.
[Documentation continues with remaining blocks...]

View File

@@ -1,35 +0,0 @@
## Block Installation
### What it is
A specialized tool designed for developers to add new blocks to the system through code verification and installation.
### What it does
This block serves as a management tool that allows for the verification and installation of new blocks into the system. It takes Python code as input, verifies its structure and validity, and then installs it as a new functional block if all checks pass.
### How it works
The block follows a systematic process:
1. Receives the code for a new block
2. Checks if the code contains a valid block class definition
3. Verifies if the code includes a proper unique identifier (UUID)
4. Creates a new file with the provided code
5. Tests the functionality of the new block
6. Either confirms successful installation or removes the file if there are any errors
### Inputs
- Code: The complete Python code for the new block that needs to be installed. This should include all necessary class definitions, methods, and a unique identifier.
### Outputs
- Success: A confirmation message indicating that the block has been successfully installed and tested
- Error: A detailed error message if the installation fails, including both the problematic code and the specific error encountered
### Possible use case
A developer creates a new custom block for data processing and needs to add it to the system. They can use the Block Installation block to:
1. Submit their block's code
2. Verify that it meets all system requirements
3. Install it safely with proper error handling
4. Confirm it's working as intended
### Important Note
This block is primarily intended for development purposes and should be used with caution as it allows for remote code execution on the server. It comes disabled by default as a security measure.

View File

@@ -1,57 +0,0 @@
# Blocks System Documentation
## Block System Overview
### What it is
A dynamic system for loading and managing modular components called "Blocks" that can be used to build workflows and processes.
### What it does
- Automatically discovers and loads Block modules
- Validates Block implementations
- Manages a registry of available Blocks
- Ensures Block compatibility and proper configuration
### How it works
The system scans for Block modules, loads them dynamically, and performs several validation checks:
- Ensures proper naming conventions
- Validates unique Block IDs
- Checks schema definitions
- Verifies proper field annotations
- Confirms default values for boolean fields
### System Requirements for Blocks
Each Block in the system must:
1. Have a name ending with "Block" (unless it's a base class ending with "Base")
2. Contain a valid UUID as its ID
3. Have properly defined input and output schemas
4. Include proper field annotations and descriptions
5. Provide default values for boolean fields
### Block Schema Structure
#### Input Schema Requirements
- Must have properly annotated fields
- Each field must include schema information
- Boolean fields must have default values
#### Output Schema Requirements
- Must have properly annotated fields
- Error fields must be string type
- Each field must include schema information
### Best Practices
1. Use clear, descriptive names for Blocks
2. Ensure unique IDs for each Block
3. Properly document all input and output fields
4. Follow the naming conventions
5. Include comprehensive schema definitions
### Common Use Cases
- Creating modular workflow components
- Building data processing pipelines
- Implementing reusable business logic
- Constructing automated task sequences
Note: This documentation describes the Block system's framework. Specific Block implementations would need their own detailed documentation following this structure.

View File

@@ -1,44 +0,0 @@
## Code Execution Block
### What it is
A secure environment for executing code in various programming languages with internet access and customizable setup options.
### What it does
This block allows users to run code in multiple programming languages (Python, JavaScript, Bash, R, and Java) within an isolated sandbox environment. It supports custom setup commands, timeout settings, and provides detailed execution outputs.
### How it works
1. Creates a secure sandbox environment using E2B credentials
2. Runs any specified setup commands (like installing packages)
3. Executes the provided code in the chosen programming language
4. Collects and returns the execution results, including any output or errors
5. Automatically terminates if there are errors or timeout is reached
### Inputs
- **API Key Credentials**: Your E2B Sandbox API key for authentication
- **Setup Commands**: Optional shell commands to prepare the environment (e.g., installing packages)
- **Code**: The actual code you want to execute
- **Programming Language**: Choice of Python (default), JavaScript, Bash, R, or Java
- **Timeout**: Maximum execution time in seconds (default: 300 seconds)
- **Template ID**: Optional E2B sandbox template ID for custom configurations
### Outputs
- **Response**: The main output from your code execution
- **Standard Output Logs**: Detailed logs of what your code printed during execution
- **Standard Error Logs**: Any error messages or warnings generated during execution
- **Error**: Specific error messages if the execution failed
### Possible use cases
1. **Educational Platform**: Teachers can create interactive coding exercises where students can write and test code in various languages
2. **Code Testing Environment**: Developers can test potentially risky code in a safe, isolated environment
3. **API Testing**: Testing API integrations without affecting the main system
4. **Code Demonstrations**: Creating live code demonstrations for presentations or tutorials
5. **Package Compatibility Testing**: Testing software packages and their dependencies in an isolated environment
### Notes
- The sandbox includes pre-installed package managers like pip and npm
- Internet access is available within the sandbox
- The environment is Debian-based
- Each execution runs in isolation to ensure security
- CPU and memory customization is available through sandbox templates

View File

@@ -1,44 +0,0 @@
## Code Execution Block
### What it is
A secure sandbox environment that allows users to execute code in various programming languages with internet access while maintaining isolation for safety.
### What it does
This block enables users to run code snippets in different programming languages (Python, JavaScript, Bash, R, and Java), set up the environment with custom commands, and receive execution results along with any output or error messages.
### How it works
The block creates an isolated sandbox environment using E2B's infrastructure. It first runs any setup commands to prepare the environment, then executes the provided code in the specified programming language. The system captures all outputs, including standard output, error messages, and execution results, and returns them to the user.
### Inputs
- Credentials: E2B API key required to access the sandbox environment
- Setup Commands: Optional shell commands to prepare the environment before code execution (e.g., installing packages or downloading resources)
- Code: The actual code to be executed in the sandbox
- Programming Language: Choice of language to execute the code (Python, JavaScript, Bash, R, or Java)
- Timeout: Maximum time in seconds allowed for code execution (default: 300 seconds)
- Template ID: Optional E2B sandbox template ID for customized environments with specific CPU and memory configurations
### Outputs
- Response: The main output or return value from the code execution
- Standard Output Logs: Any text output generated during code execution (printed messages, status updates, etc.)
- Standard Error Logs: Any error messages or warnings generated during execution
- Error: Detailed error message if the code execution fails
### Possible use cases
- Educational platforms where students can practice coding in a safe environment
- Technical interviews where candidates need to write and test code
- Development teams testing code snippets in isolation
- Automated code testing systems
- Interactive coding tutorials and workshops
- API testing and prototyping
- Script automation with different programming languages
- Security testing in an isolated environment
### Additional Notes
- The sandbox environment comes with pre-installed package managers (pip and npm)
- Users can customize the environment using Debian-based package managers
- The environment has internet access for downloading dependencies
- Custom templates can be used for specific resource requirements
- The system automatically kills the sandbox if an error occurs
- All executions are isolated to prevent security issues

View File

@@ -1,47 +0,0 @@
## Code Extraction Block
### What it is
A specialized tool that identifies and extracts code snippets written in different programming languages from within a text document.
### What it does
This block scans through text content and automatically identifies and separates code blocks written in various programming languages. It can recognize and extract code written in multiple languages, including HTML, Python, JavaScript, and many others, while preserving the remaining non-code text.
### How it works
The block processes text by:
1. Looking for code blocks that are marked with special delimiters
2. Identifying the programming language of each code block
3. Extracting and organizing the code by language
4. Separating the regular text from the code blocks
5. Providing both the extracted code and remaining text as organized outputs
### Inputs
- Text: The input text that contains code blocks to be extracted. This could be anything from an AI response to a technical document that includes programming examples.
### Outputs
- HTML: Extracted HTML markup code
- CSS: Extracted styling code
- JavaScript: Extracted JavaScript programming code
- Python: Extracted Python programming code
- SQL: Extracted database query code
- Java: Extracted Java programming code
- C++: Extracted C++ programming code
- C#: Extracted C# programming code
- JSON: Extracted JSON data format code
- Bash: Extracted command-line shell scripts
- PHP: Extracted PHP programming code
- Ruby: Extracted Ruby programming code
- YAML: Extracted YAML configuration code
- Markdown: Extracted Markdown formatting code
- TypeScript: Extracted TypeScript programming code
- XML: Extracted XML markup code
- Remaining Text: The original text with all code blocks removed
### Possible use cases
1. Processing AI-generated responses that contain multiple code examples
2. Extracting code samples from technical documentation
3. Separating programming tutorials into code and explanatory text
4. Organizing mixed content documents into code and non-code sections
5. Preparing content for technical documentation where code needs to be handled separately from regular text
6. Processing educational materials that contain multiple programming language examples

View File

@@ -1,38 +0,0 @@
## Condition Block
### What it is
A logical comparison tool that evaluates two values based on a specified operator and produces different outputs depending on whether the condition is true or false.
### What it does
This block compares two values using standard comparison operators (like equal to, greater than, less than) and outputs both the comparison result and corresponding values based on whether the condition was met or not.
### How it works
1. Takes two values and a comparison operator as input
2. Converts string numbers to actual numbers if possible
3. Performs the comparison using the selected operator
4. Outputs the result (true/false) and the corresponding value based on the result
5. If custom output values aren't provided, uses the input values as defaults
### Inputs
- Value 1: The first value to compare (can be a number, text, or boolean)
- Operator: The comparison operator to use (equals, not equals, greater than, less than, greater than or equal to, less than or equal to)
- Value 2: The second value to compare (can be a number, text, or boolean)
- Yes Value: (Optional) A custom value to output if the condition is true
- No Value: (Optional) A custom value to output if the condition is false
### Outputs
- Result: A boolean value (true/false) indicating whether the condition was met
- Yes Output: The value produced when the condition is true (either Yes Value or Value 1)
- No Output: The value produced when the condition is false (either No Value or Value 2)
### Possible use cases
1. Age verification: Compare a user's age with a minimum required age and output whether they can access content
2. Price comparison: Compare product prices and output whether something is within budget
3. Temperature control: Compare current temperature with a threshold and output different actions
4. Score evaluation: Compare test scores with passing grades and output pass/fail messages
5. Stock alerts: Compare current stock prices with target prices and output buy/sell signals
Example scenario:
A shopping app that compares a cart total ($45) with a free shipping threshold ($50). If the cart total is less than the threshold, it outputs "Add $5 more for free shipping"; if it's greater than or equal to the threshold, it outputs "Free shipping eligible!"

View File

@@ -1,47 +0,0 @@
# Discord Integration Blocks
## Read Discord Messages
### What it is
A block that monitors and captures messages from a Discord channel using a bot token.
### What it does
This block connects to Discord and listens for new messages in channels where the bot is present. It can capture regular text messages and also handle file attachments (text and Python files).
### How it works
The block establishes a connection to Discord using a bot token, waits for new messages, and when a message is received, it processes both the message content and any attached files. If a text file is attached, it will read and include its contents in the output.
### Inputs
- Discord Credentials: A bot token that allows the block to connect to Discord servers and read messages
### Outputs
- Message Content: The actual text content of the received message, including any processed file attachments
- Channel Name: The name of the Discord channel where the message was received
- Username: The name of the user who sent the message
### Possible use case
A company wants to monitor their Discord support channel and automatically process customer inquiries. This block could capture the messages and feed them into other blocks for automated response generation or ticket creation.
## Send Discord Message
### What it is
A block that sends messages to specific Discord channels using a bot token.
### What it does
This block enables automated message sending to Discord channels. It can handle long messages by automatically splitting them into appropriate sizes that Discord can process.
### How it works
The block connects to Discord using a bot token, locates the specified channel, and sends the provided message. If the message is too long, it automatically splits it into smaller chunks to comply with Discord's message size limits.
### Inputs
- Discord Credentials: A bot token that allows the block to connect to Discord servers and send messages
- Message Content: The text content you want to send to Discord
- Channel Name: The name of the Discord channel where you want to send the message
### Outputs
- Status: A message indicating whether the operation was successful ("Message sent") or if there was an error
### Possible use case
An automated notification system that needs to send updates to a Discord channel. For example, a development team could use this block to automatically post deployment status updates or system alerts to their Discord server.

View File

@@ -1,39 +0,0 @@
## Send Email Block
### What it is
A specialized block designed to send emails using SMTP (email server) credentials, making it easy to send emails directly from your workflow.
### What it does
This block allows you to send emails to specified recipients with customized subjects and message content using your email server credentials.
### How it works
1. Takes your email server credentials and message details as input
2. Connects securely to the specified email server
3. Authenticates using the provided username and password
4. Sends the email to the specified recipient
5. Returns the status of the sending operation
### Inputs
- To Email: The recipient's email address where the message will be sent
- Subject: The title or subject line of the email
- Body: The main content or message of the email
- Credentials:
- SMTP Server: The email server address (default: smtp.gmail.com)
- SMTP Port: The server port number (default: 25)
- SMTP Username: Your email address or username for authentication
- SMTP Password: Your email account password or application-specific password
### Outputs
- Status: A message indicating whether the email was sent successfully
- Error: A description of what went wrong if the email sending failed
### Possible use case
An automated notification system that sends email alerts when specific events occur. For example:
- Sending confirmation emails to users after they complete a registration
- Notifying team members when a task is completed
- Sending automated reports to stakeholders at scheduled intervals
- Alerting system administrators about critical system events
The block can be integrated into larger workflows where email communication is required as part of an automated process.

View File

@@ -1,36 +0,0 @@
## Google Maps Search
### What it is
A specialized search tool that connects with Google Maps to find and retrieve information about local businesses and places.
### What it does
This block searches for places and businesses using the Google Maps API based on user-provided search criteria. It returns detailed information about each found location, including name, address, phone number, rating, review count, and website.
### How it works
The block takes a search query and parameters from the user, connects to Google Maps using an API key, performs the search, and then collects detailed information about each matching location. It processes the results and returns them one at a time, ensuring that users get comprehensive information about each place found.
### Inputs
- Google Maps API Key: Authentication credentials required to access the Google Maps service
- Search Query: Text describing what you're looking for (e.g., "restaurants in New York")
- Search Radius: The distance (in meters) from the center point to search within, up to 50,000 meters (50 km)
- Maximum Results: The maximum number of places to return, up to 60 results
### Outputs
- Place Information: For each location found, returns:
- Name: The business or location name
- Address: Complete formatted address
- Phone: Contact phone number
- Rating: Average rating (out of 5)
- Reviews: Total number of user reviews
- Website: Associated website URL
- Error Message: Information about what went wrong if the search fails
### Possible use cases
- A restaurant discovery app that helps users find dining options in their area
- A real estate application searching for nearby amenities around properties
- A tourism platform helping visitors discover attractions in a specific area
- A business analysis tool gathering information about local competitors
- A local service directory helping users find specific businesses like mechanics or dentists within their preferred radius

View File

@@ -1,39 +0,0 @@
## Send Web Request
### What it is
A block that allows you to send HTTP requests to web servers and handle their responses.
### What it does
This block sends web requests to specified URLs, supporting various request methods (GET, POST, PUT, etc.), and processes the server's responses. It can handle both JSON and plain text data formats and manages different types of responses including successful responses and error states.
### How it works
1. Takes a URL and request details as input
2. Formats the request according to specified parameters
3. Sends the request to the specified web server
4. Receives the response from the server
5. Processes the response based on its status code
6. Returns the appropriate output based on whether the request was successful or encountered errors
### Inputs
- URL: The web address where the request will be sent (e.g., "https://api.example.com")
- Method: The type of HTTP request to make (GET, POST, PUT, DELETE, PATCH, OPTIONS, or HEAD)
- Headers: Additional information sent with the request, such as authentication tokens or content type specifications
- JSON Format: A yes/no option to specify whether the request and response should be treated as JSON data
- Body: The main content of the request being sent to the server
### Outputs
- Response: The data received from the server when the request is successful (2xx status codes)
- Client Error: Error information received when there's a client-side problem (4xx status codes)
- Server Error: Error information received when there's a server-side problem (5xx status codes)
### Possible use cases
- Integrating with external APIs (e.g., sending customer data to a CRM system)
- Fetching data from web services (e.g., getting weather information)
- Submitting forms to web servers
- Updating information in remote databases
- Validating web services by checking their responses
- Automated testing of web endpoints
- Synchronizing data between different systems

View File

@@ -1,56 +0,0 @@
## Ideogram Model Block
### What it is
A specialized block that interfaces with Ideogram's AI image generation service to create custom images based on text descriptions.
### What it does
Generates images from text prompts using Ideogram's advanced AI models, with options for customizing the image generation process and upscaling the results.
### How it works
The block takes a text prompt and various customization parameters, sends them to Ideogram's API, and returns a URL containing the generated image. If upscaling is requested, it processes the image through an additional enhancement step.
### Inputs
- Credentials: Ideogram API key required for authentication
- Prompt: Text description of the image you want to generate
- Image Generation Model: Choice of Ideogram's AI models (V2, V1, V1 Turbo, V2 Turbo)
- Aspect Ratio: Image dimensions ratio (multiple options from 1:1 to 16:9)
- Upscale Image: Option to enhance image resolution using AI
- Magic Prompt Option: Setting for automatic prompt enhancement (Auto, On, Off)
- Seed: Optional number for reproducible image generation
- Style Type: Visual style preference (Auto, General, Realistic, Design, 3D Render, Anime)
- Negative Prompt: Description of elements to exclude from the image
- Color Palette Preset: Predefined color schemes (None, Ember, Fresh, Jungle, etc.)
### Outputs
- Result: URL of the generated image
- Error: Message explaining any issues that occurred during generation
### Possible use cases
- Creating custom illustrations for a blog post
- Generating concept art for a video game or film
- Designing marketing materials with specific visual requirements
- Producing consistent branded imagery with predefined color palettes
- Creating architectural visualizations with specific style requirements
- Generating product mockups with controlled aspect ratios
- Developing storyboard frames for animation or film projects
- Creating social media content with platform-specific aspect ratios
### Advanced Features
1. Reproducible Generation:
- Use the seed parameter to create consistent results across multiple generations
- Useful for maintaining visual consistency in a series of images
2. Style Control:
- Fine-tune the visual output using style presets
- Combine with color palettes for branded content
3. Quality Enhancement:
- AI upscaling for higher resolution outputs
- Particularly useful for large-format printing or detailed digital displays
4. Flexible Output Formats:
- Multiple aspect ratio options for different use cases
- Suitable for various digital platforms and print media
Note: This block requires valid Ideogram API credentials with appropriate permissions for the selected features.

View File

@@ -1,136 +0,0 @@
# LLM Blocks Documentation
## AI Structured Response Generator
### What it is
A block that generates structured responses using Large Language Models (LLMs).
### What it does
Generates formatted object responses based on given prompts, ensuring the output follows a specific structure or format.
### How it works
Takes a prompt and expected format, sends it to an LLM, and ensures the response matches the required structure. If the response doesn't match the format, it retries automatically.
### Inputs
- Prompt: The text prompt to send to the language model
- Expected Format: Dictionary defining the structure the response should follow
- Model: Choice of LLM to use (e.g., GPT-4, Claude, etc.)
- Credentials: API key for the chosen LLM provider
- System Prompt: Additional context for the model
- Conversation History: Previous messages for context
- Retry Count: Number of attempts to get a valid response
- Prompt Values: Variables to fill in prompt templates
- Max Tokens: Maximum length of the generated response
### Outputs
- Response: The structured object generated by the model
- Error: Any error message if the process fails
### Possible use case
Extracting specific information from customer reviews into a structured format, such as converting free-text feedback into categorized ratings and comments.
## AI Text Generator
### What it is
A block that generates free-form text responses using LLMs.
### What it does
Produces natural language responses based on given prompts without enforcing specific formats.
### How it works
Sends prompts to an LLM and returns the raw text response, allowing for more creative and flexible outputs.
### Inputs
- Prompt: The text prompt for the model
- Model: Choice of LLM to use
- Credentials: API key for the chosen provider
- System Prompt: Additional context for the model
- Retry Count: Number of retry attempts
- Prompt Values: Variables for template filling
### Outputs
- Response: The generated text
- Error: Any error message if the process fails
### Possible use case
Creating blog post drafts, generating creative stories, or writing marketing copy based on given topics.
## AI Text Summarizer
### What it is
A block that creates concise summaries of longer texts using LLMs.
### What it does
Breaks down long texts into manageable chunks, summarizes each chunk, and combines them into a final summary.
### How it works
Processes text in chunks to handle long documents, maintains context through overlap, and recursively summarizes if needed.
### Inputs
- Text: The long text to summarize
- Model: Choice of LLM to use
- Focus: Specific topic to focus on in the summary
- Style: Summary format (concise, detailed, bullet points, numbered list)
- Max Tokens: Maximum length for processing
- Chunk Overlap: How much context to maintain between chunks
### Outputs
- Summary: The final summarized text
- Error: Any error message if the process fails
### Possible use case
Summarizing long research papers, creating executive summaries of reports, or condensing meeting transcripts.
## AI Conversation Block
### What it is
A block that manages multi-turn conversations with LLMs.
### What it does
Handles back-and-forth dialogue between users and AI models, maintaining conversation context.
### How it works
Processes a list of messages representing a conversation and generates appropriate responses while maintaining context.
### Inputs
- Messages: List of previous conversation messages
- Model: Choice of LLM to use
- Credentials: API key for the chosen provider
- Max Tokens: Maximum response length
### Outputs
- Response: The model's reply to the conversation
- Error: Any error message if the process fails
### Possible use case
Creating interactive chatbots, virtual assistants, or customer service automation.
## AI List Generator
### What it is
A block that generates lists of items based on given criteria or source data.
### What it does
Creates structured lists of items either from provided source data or based on specific focus criteria.
### How it works
Analyzes source data or focus requirements and generates a properly formatted list of relevant items.
### Inputs
- Focus: The specific topic or criteria for the list
- Source Data: Optional text to extract list items from
- Model: Choice of LLM to use
- Credentials: API key for the chosen provider
- Max Retries: Number of attempts to generate a valid list
- Max Tokens: Maximum response length
### Outputs
- Generated List: The complete list of items
- List Item: Individual items from the list
- Error: Any error message if the process fails
### Possible use case
Extracting key points from articles, generating todo lists, or creating categorical listings from unstructured text.

View File

@@ -1,47 +0,0 @@
# Mathematical Operations Blocks Documentation
## Calculator
### What it is
A versatile mathematical calculator that performs basic arithmetic operations between two numbers.
### What it does
Performs one of five mathematical operations (addition, subtraction, multiplication, division, or power) on two numbers and provides the result. It also includes an option to round the result to the nearest whole number.
### How it works
The calculator takes two numbers and a selected operation as input. It then performs the chosen mathematical operation on these numbers and returns the result. If division by zero is attempted, it returns infinity. For any other errors, it returns "NaN" (Not a Number).
### Inputs
- Operation: Choose from Add, Subtract, Multiply, Divide, or Power
- Number A: The first number in the calculation
- Number B: The second number in the calculation
- Round Result: Toggle whether you want the result rounded to the nearest whole number
### Outputs
- Result: The final calculated value from the operation
### Possible use case
A financial application that needs to perform various calculations, such as computing interest rates, calculating discounts, or determining payment installments.
## Count Items
### What it is
A counter that determines the number of items in any collection of data.
### What it does
Counts and returns the total number of items in various types of collections, such as lists, dictionaries, strings, or any other countable group of items.
### How it works
The block examines the provided collection and counts its elements. It can handle different types of collections (strings, lists, dictionaries, etc.) and returns the total count. If it encounters an error or receives an invalid input, it returns -1.
### Inputs
- Collection: The group of items you want to count (can be a list, dictionary, string, or any other collection of items)
### Outputs
- Count: The total number of items found in the collection
### Possible use case
An inventory management system that needs to quickly count items in different categories, or a text analysis tool that needs to count characters, words, or sentences in a document.

View File

@@ -1,45 +0,0 @@
## Publish to Medium Block
### What it is
A functional block that enables automated publishing of content to the Medium platform, allowing users to create and manage posts programmatically.
### What it does
This block publishes content to Medium with customizable settings, including the ability to set the post's status (public, draft, or unlisted), add tags, and configure various publishing options.
### How it works
The block connects to the Medium API using provided credentials, processes the user's content and settings, and creates a new post on the platform. It handles the entire publishing workflow, from authentication to post creation, and returns information about the published content.
### Inputs
- Author ID: The unique identifier for the Medium author account where the content will be published
- Title: The headline or title of the Medium post
- Content: The main body of the post, which can be in HTML or Markdown format
- Content Format: Specifies whether the content is formatted in HTML or Markdown
- Tags: Up to 5 topic tags that categorize the post (helps with content discovery)
- Canonical URL: Optional link to the original source if the content was published elsewhere first
- Publish Status: Sets whether the post should be public, draft, or unlisted
- License: The content license type (e.g., all-rights-reserved, creative commons options)
- Notify Followers: Option to notify followers about the new post
- Credentials: Medium API authentication details needed to publish content
### Outputs
- Post ID: The unique identifier assigned to the published post
- Post URL: The direct web link to access the published content on Medium
- Published At: The timestamp indicating when the post was published
- Error: Any error message if the publishing process fails
### Possible use cases
- Content syndication: Automatically republish blog posts from your website to Medium
- Content distribution: Share company updates or announcements across platforms
- Draft management: Create draft posts for review before public release
- Cross-platform publishing: Part of a workflow that publishes content to multiple platforms
- Automated content scheduling: Schedule posts to be published at specific times
- Content archiving: Maintain a backup of your content on Medium
### Notes
- The block supports different publishing states (public, draft, unlisted) for flexible content management
- You can control whether followers are notified about new posts
- The block handles proper attribution through canonical URLs
- Multiple license options are available to protect your content rights
- Error handling is built-in to provide clear feedback if publishing fails

View File

@@ -1,81 +0,0 @@
# Pinecone Blocks Documentation
## Pinecone Initialize
### What it is
A block that sets up and initializes a Pinecone vector database index.
### What it does
Creates a new Pinecone index if it doesn't exist, or connects to an existing one if it does. This index will be used to store and search through vector data.
### How it works
The block connects to Pinecone using your API credentials, checks if the requested index exists, and either creates a new one with your specified settings or connects to the existing one.
### Inputs
- Credentials: Your Pinecone API key for authentication
- Index Name: The name you want to give to your Pinecone index
- Dimension: The size of the vectors to be stored (default: 768)
- Metric: The method used to measure similarity between vectors (default: cosine)
- Cloud: The cloud provider for serverless deployment (default: aws)
- Region: The geographical region for your index (default: us-east-1)
### Outputs
- Index: The name of the initialized Pinecone index
- Message: A status message indicating whether the index was created or already existed
### Possible use case
Setting up a new vector database to store document embeddings for a semantic search application.
## Pinecone Query
### What it is
A block that searches through vectors stored in a Pinecone index to find similar items.
### What it does
Takes a query vector and searches the Pinecone index to find the most similar vectors, returning the top matches along with their associated metadata.
### How it works
The block connects to your Pinecone index, performs a similarity search using your query vector, and returns the most relevant results based on your specified parameters.
### Inputs
- Credentials: Your Pinecone API key for authentication
- Query Vector: The vector to search for in the index
- Namespace: A specific section of the index to search in (optional)
- Top K: Number of results to return (default: 3)
- Include Values: Whether to include vector values in results (default: false)
- Include Metadata: Whether to include metadata in results (default: true)
- Host: The Pinecone host address
- Index Name: The name of the Pinecone index to query
### Outputs
- Results: The raw query results from Pinecone
- Combined Results: A consolidated version of the results
### Possible use case
Implementing a semantic search feature where users can find similar documents based on meaning rather than exact keyword matches.
## Pinecone Insert
### What it is
A block that uploads new vector data to a Pinecone index.
### What it does
Takes text chunks and their corresponding vector embeddings and stores them in the Pinecone index along with any additional metadata.
### How it works
The block connects to your Pinecone index, processes the provided chunks and embeddings, assigns unique IDs to each vector, and uploads them to the specified namespace in the index.
### Inputs
- Credentials: Your Pinecone API key for authentication
- Index: The name of the initialized Pinecone index
- Chunks: List of text pieces to be stored
- Embeddings: Vector representations of the text chunks
- Namespace: Specific section of the index to store data in (optional)
- Metadata: Additional information to store with the vectors
### Outputs
- Upsert Response: Confirmation message about the upload status
### Possible use case
Uploading a collection of documents to a vector database after converting them into embeddings, allowing them to be searched semantically later.

View File

@@ -1,36 +0,0 @@
## CSV Reader
### What it is
A tool that reads and processes CSV (Comma-Separated Values) files, converting them into a more usable format.
### What it does
This block takes CSV-formatted text and transforms it into structured data, processing it row by row while allowing customization of how the CSV is read and interpreted. It can handle different file formats and configurations, making it versatile for various data processing needs.
### How it works
The block reads a CSV file's contents line by line, organizing the data into a structured format. It can recognize headers, skip specific rows or columns, and handle different types of delimiters and special characters. As it processes the file, it produces both individual rows and a complete collection of all the data.
### Inputs
- Contents: The actual CSV text data you want to process
- Delimiter: The character that separates values in your CSV (defaults to comma)
- Quote Character: The character used to enclose text fields (defaults to double quote)
- Escape Character: The character used to escape special characters (defaults to backslash)
- Has Header: Whether your CSV includes a header row (defaults to yes)
- Skip Rows: Number of rows to skip at the beginning of the file (defaults to 0)
- Strip: Whether to remove extra spaces from values (defaults to yes)
- Skip Columns: List of columns you want to exclude from the results (defaults to none)
### Outputs
- Row: Each individual row of data as it's processed, presented as a collection of key-value pairs
- All Data: The complete set of all rows from the CSV file, presented as a list of key-value pair collections
### Possible use case
A data analyst needs to process customer information stored in a CSV file. The file contains customer names, addresses, and purchase history, but has some extra header rows and unnecessary columns. Using this block, they can:
1. Skip the extra header rows
2. Exclude sensitive columns like customer IDs
3. Clean up the data by removing extra spaces
4. Process the information either row by row for immediate analysis or as a complete dataset for bulk processing
5. Use the structured output for further analysis or integration with other systems
The block would handle all the complexities of reading and parsing the CSV file while providing clean, structured data ready for use in their analysis.

View File

@@ -1,51 +0,0 @@
## Get Reddit Posts
### What it is
A block designed to fetch posts from a specified subreddit on Reddit.
### What it does
This block retrieves a collection of posts from a designated subreddit, allowing users to specify various filtering criteria such as time limits and post limits.
### How it works
The block connects to Reddit using provided credentials, accesses the specified subreddit, and retrieves posts based on the given parameters. It can filter posts based on time and stop when reaching a specific post ID.
### Inputs
- Subreddit: The name of the subreddit from which to fetch posts
- Credentials: Reddit authentication details including client ID, client secret, username, password, and user agent
- Last Minutes: Optional filter to only fetch posts from the last X minutes
- Last Post: Optional post ID where the fetching should stop
- Post Limit: Maximum number of posts to fetch (defaults to 10)
### Outputs
- Post: A Reddit post object containing:
- ID: Unique identifier of the post
- Subreddit: Name of the subreddit
- Title: Post title
- Body: Post content
### Possible use case
A social media monitoring tool that needs to track recent discussions in specific Reddit communities, such as gathering customer feedback from a company's subreddit.
## Post Reddit Comment
### What it is
A block that enables posting comments on Reddit posts.
### What it does
This block takes a comment and posts it as a reply to a specified Reddit post.
### How it works
The block authenticates with Reddit using provided credentials, locates the specified post using its ID, and adds the provided comment as a reply to that post.
### Inputs
- Credentials: Reddit authentication details including client ID, client secret, username, password, and user agent
- Comment Data: Contains:
- Post ID: The ID of the post to comment on
- Comment: The text content of the comment
### Outputs
- Comment ID: The unique identifier of the posted comment
### Possible use case
An automated customer service system that needs to respond to customer inquiries or posts on a company's Reddit community, or a social media management tool that schedules and posts responses to Reddit discussions.

View File

@@ -1,46 +0,0 @@
## Replicate Flux Advanced Model
### What it is
A sophisticated image generation block that uses various Flux models (Schnell, Pro, and Pro 1.1) through the Replicate platform to create custom images based on text descriptions.
### What it does
This block generates high-quality images from text prompts, allowing users to control various aspects of the image generation process through advanced settings like image quality, aspect ratio, and safety parameters.
### How it works
The block takes a text prompt and various configuration parameters, sends them to the selected Flux model on Replicate's platform, and returns a URL containing the generated image. It handles different image formats and provides extensive control over the generation process through multiple customizable parameters.
### Inputs
- Credentials: Replicate API key required for accessing the service
- Prompt: Text description of the image you want to generate
- Image Generation Model: Choice between Flux Schnell, Flux Pro, or Flux Pro 1.1 models
- Seed: Optional numerical value for reproducible image generation
- Steps: Number of diffusion steps (default: 25)
- Guidance: Controls how closely the image follows the prompt (default: 3.0)
- Interval: Controls output variance and consistency (default: 2.0)
- Aspect Ratio: Image dimensions ratio (options: 1:1, 16:9, 2:3, 3:2, 4:5, 5:4, 9:16)
- Output Format: Image file format (WEBP, JPG, or PNG)
- Output Quality: Image quality setting from 0-100 (default: 80)
- Safety Tolerance: Content safety level from 1 (strict) to 5 (permissive)
### Outputs
- Result: URL link to the generated image
- Error: Error message if the image generation process fails
### Possible use cases
- Creating custom artwork for websites or marketing materials
- Generating concept art for creative projects
- Producing unique social media content
- Designing visual assets for presentations
- Creating unique illustrations for blog posts or articles
- Developing mood boards or visual inspiration
- Generating product visualization concepts
- Creating custom backgrounds or wallpapers
### Notes
- Higher guidance values produce images that more closely match the prompt but might affect overall quality
- Lower interval values ensure more consistent outputs with stronger prompt following
- The safety tolerance setting helps filter inappropriate content
- Output quality setting doesn't affect PNG format images
- Setting a specific seed allows for reproducible results

View File

@@ -1,34 +0,0 @@
## RSS Feed Reader
### What it is
A block that monitors and retrieves entries from an RSS feed, which is a standardized format for publishing updates from websites.
### What it does
This block reads and monitors an RSS feed from a specified URL, checking for new entries within a defined time period. It can either run once or continuously monitor the feed for updates.
### How it works
The block connects to a specified RSS feed URL and checks for new entries published within a specified time window. When it finds new entries, it processes them and outputs them one at a time. If set to run continuously, it will keep checking the feed at regular intervals defined by the polling rate.
### Inputs
- RSS URL: The web address of the RSS feed you want to monitor (e.g., https://example.com/rss)
- Time Period: The number of minutes to look back for new entries. For example, setting this to 60 will check for entries published in the last hour
- Polling Rate: How often the block should check for new entries, specified in seconds
- Run Continuously: A yes/no option to determine whether the block should keep checking for new entries (yes) or run just once (no)
### Outputs
- RSS Entry: A structured package of information containing:
- Title: The headline or title of the entry
- Link: The web address where the full content can be found
- Description: A summary or preview of the content
- Publication Date: When the entry was published
- Author: Who wrote or published the entry
- Categories: Labels or tags associated with the entry
### Possible use cases
- Creating a news monitoring system that tracks updates from multiple news websites
- Building a content aggregator that collects blog posts from various sources
- Setting up an alert system for new publications on specific topics
- Automating the collection of industry updates for a newsletter
- Monitoring competitor websites for new product announcements or updates

View File

@@ -1,42 +0,0 @@
## Data Sampling Block
### What it is
A specialized tool that helps select representative samples from larger datasets using various sampling methods.
### What it does
This block takes a dataset and extracts a smaller subset of data points using different sampling techniques. It can work with different data formats and supports multiple sampling methods to ensure the selected samples meet specific requirements.
### How it works
The block receives input data and a specified sampling method, then applies the chosen method to select a subset of the data. It can either process data immediately or accumulate data over time before sampling. The block supports eight different sampling methods:
- Random: Selects samples completely at random
- Systematic: Picks samples at regular intervals
- Top: Takes samples from the beginning
- Bottom: Takes samples from the end
- Stratified: Ensures samples are taken from different groups proportionally
- Weighted: Selects samples based on specified importance values
- Reservoir: Maintains a representative sample as data streams in
- Cluster: Groups similar items and samples from these groups
### Inputs
- Data: The dataset to sample from, which can be a single item or a list of items
- Sample Size: The number of samples you want to select from the dataset
- Sampling Method: The technique to use for selecting samples (defaults to random)
- Accumulate: Whether to collect data over time before sampling (defaults to false)
- Random Seed: An optional number to ensure consistent sampling results
- Stratify Key: The category field to use for stratified sampling
- Weight Key: The importance field to use for weighted sampling
- Cluster Key: The grouping field to use for cluster sampling
### Outputs
- Sampled Data: The selected subset of data points
- Sample Indices: The positions of the selected items in the original dataset
### Possible use cases
1. Quality Control: Randomly selecting products from a production line for inspection
2. Market Research: Ensuring survey responses come from different demographic groups using stratified sampling
3. Data Analysis: Creating a smaller, manageable dataset for testing analytics processes
4. Stream Processing: Maintaining a representative sample of continuous data using reservoir sampling
5. Customer Feedback: Selecting customer reviews based on purchase amounts using weighted sampling
6. Geographic Analysis: Sampling data from different regions using cluster sampling

View File

@@ -1,50 +0,0 @@
# Search Blocks Documentation
## Get Wikipedia Summary
### What it is
A block that retrieves concise summaries of topics from Wikipedia.
### What it does
This block takes a topic as input and fetches a summary description of that topic from Wikipedia's public API, making it easy to get quick, reliable information about various subjects.
### How it works
The block connects to Wikipedia's REST API, searches for the requested topic, and returns a condensed version of the article's introduction. If the topic is found, it provides a summary; if not, it returns an error message.
### Inputs
- Topic: The subject you want to learn about (e.g., "Artificial Intelligence", "Solar System", "Leonardo da Vinci")
### Outputs
- Summary: A concise overview of the requested topic from Wikipedia
- Error: A message explaining what went wrong if the summary couldn't be retrieved
### Possible use case
A student creating a research project could use this block to quickly gather initial information about different subjects, or a content creator could use it to get accurate starting points for article writing.
## Get Weather Information
### What it is
A block that provides current weather information for any location using the OpenWeatherMap service.
### What it does
This block retrieves real-time weather data including temperature, humidity, and current weather conditions for a specified location.
### How it works
The block connects to the OpenWeatherMap API using provided credentials, sends a request with the specified location, and returns current weather details. It can display temperatures in either Celsius or Fahrenheit based on user preference.
### Inputs
- Location: The place you want to get weather information for (e.g., "New York", "London", "Tokyo")
- Use Celsius: A toggle to switch between Celsius (true) and Fahrenheit (false) temperature units
- Credentials: OpenWeatherMap API credentials required to access the weather service
### Outputs
- Temperature: The current temperature in the requested location (in either Celsius or Fahrenheit)
- Humidity: The current humidity percentage in the location
- Condition: A description of the current weather (e.g., "overcast clouds", "light rain")
- Error: A message explaining what went wrong if the weather information couldn't be retrieved
### Possible use case
A travel planning application could use this block to display current weather conditions for different destinations, or a smart home system could use it to adjust indoor settings based on outdoor weather conditions.

View File

@@ -1,36 +0,0 @@
## Step Through Items
### What it is
A logic block that helps you process lists or dictionaries one item at a time in a systematic way.
### What it does
This block takes a collection of items (either a list or dictionary) and processes them one at a time, outputting each item along with its position (index or key) in sequence.
### How it works
The block accepts input data in three different formats (list, dictionary, or string representation) and processes them systematically:
1. For lists: It goes through each item in order, providing both the item and its position number
2. For dictionaries: It processes each value in the dictionary, outputting both the value and its corresponding key
3. For string inputs: It first converts the string into either a list or dictionary (if properly formatted) and then processes it accordingly
### Inputs
- items: A list of items to process (e.g., [1, 2, 3, 4, 5])
- items_object: A dictionary of items to process (e.g., {"key1": "value1", "key2": "value2"})
- items_str: A string representation of either a list or dictionary to process
### Outputs
- item: The current item being processed from the collection
- key: The position (index number for lists) or identifier (key for dictionaries) of the current item
### Possible use cases
1. Processing a list of customer orders one at a time, where each order needs individual attention
2. Analyzing survey responses sequentially, where each response needs to be evaluated independently
3. Processing a collection of data entries where each entry requires specific validation or transformation
4. Handling a series of tasks that need to be executed in sequence
5. Managing a queue of messages or notifications that need to be processed one at a time
### Notes
- The block is particularly useful when you need to perform actions on each item in a collection individually
- It can handle both simple lists (like numbers or text) and complex data structures (like nested dictionaries)
- The block will automatically skip any empty inputs, making it flexible for various use cases
- It's part of the LOGIC category of blocks, indicating its utility in controlling program flow and data processing

View File

@@ -1,46 +0,0 @@
## Create Talking Avatar Video
### What it is
A specialized block that creates video clips featuring an AI-powered digital avatar that speaks your provided text using various voice options.
### What it does
This block transforms text input into a video featuring a digital presenter speaking the provided content. It connects with D-ID's service to generate realistic talking avatar videos with customizable voices and presentation styles.
### How it works
1. Takes your text input and voice preferences
2. Sends the information to D-ID's service
3. Creates a video clip with a digital presenter speaking your text
4. Monitors the creation process until completion
5. Provides you with the final video URL
### Inputs
- Credentials: Your D-ID API key for accessing the service
- Script Input: The text you want the avatar to speak
- Provider: Choice of voice provider (Microsoft, ElevenLabs, or Amazon)
- Voice ID: The specific voice to use for speaking
- Presenter ID: The digital avatar to use in the video
- Driver ID: The animation style for the presenter
- Result Format: Output format (MP4, GIF, or WAV)
- Crop Type: Video frame style (wide, square, or vertical)
- Subtitles: Option to include subtitles in the video
- SSML: Option to use Speech Synthesis Markup Language for advanced voice control
- Max Polling Attempts: Maximum number of times to check if the video is ready
- Polling Interval: Time to wait between checking video status
### Outputs
- Video URL: The web address where you can access your completed video
- Error: Any error message if the video creation fails
### Possible use cases
- Creating engaging video presentations for social media
- Generating multilingual training materials with consistent presenters
- Producing educational content with a virtual instructor
- Creating personalized welcome messages for websites
- Developing interactive customer service responses
- Making product demonstrations with consistent branding
- Creating automated news broadcasts
- Developing e-learning materials with visual engagement
**Note:** To ensure successful video creation, make sure to use valid voice IDs and presenter IDs as specified in the D-ID documentation. The process may take several minutes depending on the length of your script and server load.

View File

@@ -1,97 +0,0 @@
# Text Processing Blocks Documentation
## Match Text Pattern
### What it is
A text pattern matching tool that checks if a given text matches a specified pattern.
### What it does
Examines input text against a pattern and routes the data to different outputs based on whether a match is found or not.
### How it works
The block takes text and a pattern, checks if they match according to specified rules (like case sensitivity), and directs the data to either a positive or negative output channel.
### Inputs
- Text: The text content to be analyzed
- Match: The pattern to look for in the text
- Data: Information to be passed through to the output
- Case Sensitive: Whether uppercase and lowercase letters should be treated as different
- Dot All: Whether the dot character should match any character including newlines
### Outputs
- Positive: Forwards the data when a pattern match is found
- Negative: Forwards the data when no pattern match is found
### Possible use case
Sorting customer feedback messages into different categories based on specific keywords or patterns.
## Extract Text Information
### What it is
A text extraction tool that pulls out specific information from text based on patterns.
### What it does
Searches through text to find and extract specific portions that match a given pattern.
### How it works
The block searches for pattern matches in the text and extracts either the whole match or specific groups within the match, with options for finding single or multiple occurrences.
### Inputs
- Text: The source text to extract information from
- Pattern: The pattern that defines what to extract
- Group: Which part of the match to extract
- Case Sensitive: Whether to consider letter case during matching
- Dot All: Whether the dot character matches any character including newlines
- Find All: Whether to find one or all matches
### Outputs
- Positive: The extracted text when matches are found
- Negative: The original text when no matches are found
### Possible use case
Extracting phone numbers or email addresses from a document.
## Fill Text Template
### What it is
A template-based text formatter that creates customized text using provided values.
### What it does
Fills in a text template with specific values to create formatted text output.
### How it works
The block takes a template with placeholders and replaces them with corresponding values from a provided dictionary.
### Inputs
- Values: A dictionary of values to insert into the template
- Format: The template text with placeholders for the values
### Outputs
- Output: The final formatted text with all placeholders replaced with values
### Possible use case
Creating personalized email messages by filling in customer names and specific details in a template.
## Combine Texts
### What it is
A text combination tool that joins multiple text pieces into a single text.
### What it does
Merges multiple separate text inputs into one unified text output, with an optional delimiter between them.
### How it works
The block takes a list of text pieces and joins them together, optionally placing a specified delimiter between each piece.
### Inputs
- Input: A list of text pieces to combine
- Delimiter: The text to insert between combined pieces (optional)
### Outputs
- Output: The final combined text
### Possible use case
Combining multiple paragraphs into a single document, or joining separate pieces of information with commas or spaces between them.

View File

@@ -1,35 +0,0 @@
## Text Decoder
### What it is
A specialized tool that converts text containing special escape sequences into their proper readable format.
### What it does
This block takes text that contains special characters written in an escaped format (like '\n' for new lines or '\"' for quotation marks) and converts them into their actual readable representations. It transforms encoded special characters into their proper visual format.
### How it works
The block processes the input text by identifying special character sequences (escape sequences) and replacing them with their actual intended characters. For example, when it sees '\n', it creates an actual line break in the text, and when it sees '\"', it creates an actual quotation mark.
### Inputs
- Text: The input text that contains escaped characters. This can be any text string that includes special characters written in their escaped form (like \n for new lines or \" for quote marks).
### Outputs
- Decoded Text: The final text with all escape sequences properly converted into their actual characters. The output shows the text as it was meant to be displayed, with proper formatting and special characters.
### Possible use cases
1. Converting copied code comments into readable documentation
2. Processing user input that contains special formatting
3. Cleaning up text exported from various systems where special characters were escaped
4. Converting formatted strings from programming languages into human-readable text
5. Processing JSON or other data format strings where special characters are escaped
For example, if you have text copied from a programming file that looks like:
"Hello\nWorld!\nThis is a \"quoted\" string"
The block will convert it to display as:
```
Hello
World!
This is a "quoted" string
```
This block is particularly useful when working with text that comes from technical sources or programming environments and needs to be converted into a human-readable format.

View File

@@ -1,90 +0,0 @@
# Time Management Blocks Documentation
## Get Current Time
### What it is
A block that provides the current time in a specified format.
### What it does
Returns the current time according to your system clock in a customizable format.
### How it works
When triggered, the block reads your system's current time and formats it according to your specifications. If no format is specified, it uses the default format of hours:minutes:seconds (HH:MM:SS).
### Inputs
- Trigger: Any input that activates the block
- Format: Optional time format pattern (default is HH:MM:SS)
### Outputs
- Time: The current time in the specified format
### Possible use case
Creating automated time-based notifications or logging timestamps in a specific format for reports.
## Get Current Date
### What it is
A block that provides the current date with optional date offset capabilities.
### What it does
Returns the current date or a date offset by a specified number of days, formatted according to your preferences.
### How it works
Reads the system date and applies any specified offset (forward or backward in days), then formats the result according to your specifications. The default format is YYYY-MM-DD.
### Inputs
- Trigger: Any input that activates the block
- Days Offset: Number of days to adjust the date forward or backward (default is 0)
- Format: Optional date format pattern (default is YYYY-MM-DD)
### Outputs
- Date: The calculated date in the specified format
### Possible use case
Scheduling future events or calculating deadlines by offsetting from the current date.
## Get Current Date and Time
### What it is
A block that combines both date and time information into a single output.
### What it does
Provides the current date and time together in a customizable format.
### How it works
Combines the system's current date and time information into a single formatted string. The default format includes both date and time (YYYY-MM-DD HH:MM:SS).
### Inputs
- Trigger: Any input that activates the block
- Format: Optional datetime format pattern (default is YYYY-MM-DD HH:MM:SS)
### Outputs
- Date Time: The current date and time in the specified format
### Possible use case
Creating timestamps for logging events or generating datetime stamps for document creation.
## Countdown Timer
### What it is
A block that creates a customizable countdown timer with multiple time unit inputs.
### What it does
Waits for a specified duration and then outputs a message when the time is up.
### How it works
Combines all time inputs (days, hours, minutes, seconds) into a total duration, waits for that duration to pass, then delivers your specified message.
### Inputs
- Input Message: The message to display when the timer finishes (default is "timer finished")
- Seconds: Number of seconds to wait
- Minutes: Number of minutes to wait
- Hours: Number of hours to wait
- Days: Number of days to wait
### Outputs
- Output Message: The specified message that appears when the timer completes
### Possible use case
Creating delayed notifications, scheduling automated tasks, or implementing cooling-off periods in automated workflows.

View File

@@ -1,44 +0,0 @@
## Unreal Text to Speech
### What it is
A specialized block that converts written text into spoken audio using the Unreal Speech API, offering high-quality text-to-speech conversion capabilities.
### What it does
This block takes written text and transforms it into natural-sounding speech, generating an audio file that can be accessed via a URL. It allows users to specify the voice they want to use for the audio generation.
### How it works
The block operates by:
1. Taking the input text and voice selection from the user
2. Sending this information to the Unreal Speech API
3. Processing the text using the specified voice settings
4. Generating an MP3 audio file
5. Providing a URL to access the generated audio
### Inputs
- Text: The written content you want to convert into speech. This can be any text that you want to hear spoken aloud.
- Voice ID: The specific voice you want to use for the speech generation. By default, it uses a voice called "Scarlett," but other voices can be selected.
- Credentials: Authentication details required to access the Unreal Speech API. This includes an API key with the necessary permissions.
### Outputs
- MP3 URL: A web address (URL) where you can access and play the generated audio file.
- Error: A message explaining what went wrong if the text-to-speech conversion fails for any reason.
### Possible use cases
- Creating audio versions of written content for accessibility purposes
- Developing voice-overs for videos or presentations
- Building interactive voice responses for applications
- Generating automated announcements or notifications
- Creating audio content for e-learning materials
- Producing spoken versions of articles or blog posts
- Developing voice-enabled assistants or chatbots
- Creating audio books from written text
### Technical Categories
- AI
- Text Processing
### Notes
- The block uses high-quality audio settings with a 192k bitrate
- The speech can be customized with additional parameters like speed and pitch
- The system supports sentence-level timestamps for precise audio timing

View File

@@ -1,31 +0,0 @@
## Word Character Count
### What it is
A tool that analyzes text and provides information about the number of words and characters it contains.
### What it does
This block takes a piece of text as input and counts both the number of words and the total number of characters in that text. It then provides these counts as separate outputs.
### How it works
The block processes the input text in two ways:
1. It splits the text into individual words and counts them
2. It counts the total number of characters (including spaces and punctuation)
If any errors occur during processing, it will provide an error message instead.
### Inputs
- Text: The text you want to analyze. This can be any string of characters, such as a sentence, paragraph, or entire document.
### Outputs
- Word Count: The total number of words found in the input text
- Character Count: The total number of characters (including spaces and punctuation) in the input text
- Error: A message explaining what went wrong if the counting process fails
### Possible use case
A content writer could use this block to:
- Check if their article meets specific word count requirements
- Monitor the length of social media posts to ensure they fit within character limits
- Calculate the reading time for their content based on word count
- Verify the length of meta descriptions or titles for SEO purposes
For example, if you input the text "Hello, how are you?", the block will tell you that it contains 4 words and 19 characters (including spaces and punctuation marks).

View File

@@ -1,38 +0,0 @@
## Transcribe YouTube Video
### What it is
A tool that automatically extracts and converts spoken content from YouTube videos into written text.
### What it does
This block takes a YouTube video URL and creates a text transcript of all spoken content in the video. It can handle various YouTube URL formats (standard watch URLs, shortened URLs, and embedded URLs) and produces a readable text version of the video's audio content.
### How it works
The block operates in three main steps:
1. It takes the provided YouTube URL and extracts the unique video ID
2. It searches for available transcripts for the video
3. It formats the transcript into readable text, maintaining the original sequence of spoken content
### Inputs
- YouTube URL: The web address of the YouTube video you want to transcribe. This can be in various formats:
- Standard format (https://www.youtube.com/watch?v=...)
- Shortened format (https://youtu.be/...)
- Embedded format (https://www.youtube.com/embed/...)
### Outputs
- Video ID: The unique identifier of the YouTube video that was processed
- Transcript: The complete text version of the video's spoken content, formatted for easy reading
- Error: A message explaining what went wrong if the transcription process fails (for example, if no transcript is available for the video)
### Possible use cases
- Creating written documentation from educational YouTube videos
- Making video content accessible to deaf or hard-of-hearing viewers
- Generating searchable text content from video presentations
- Creating subtitles or closed captions for video content
- Extracting quotes or specific segments from video interviews
- Research and analysis of video content through text-based processing
### Notes
- The block will attempt to find transcripts in any available language if the primary language isn't available
- Not all YouTube videos have available transcripts, in which case the block will return an error message
- The quality of the transcript depends on the original caption quality provided by YouTube