8000 GitHub - hama-jp/flomoji: ๐ŸŒŠ flomoji - Visual LLM workflow builder for everyone ยท GitHub
[go: up one dir, main page]

Skip to content
hama-jpPublic

About

๐ŸŒŠ flomoji - Visual LLM workflow builder for everyone

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Latest commit

ย 

History

301 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒŠ flomoji

Visual LLM workflow builder for everyone

flomoji enables AI conversations and workflow automation without complex setup. Supporting various AI providers including OpenAI, Anthropic, and local LLMs, it streamlines your work through prompt chaining and multi-step processing.

ใƒ–ใƒฉใ‚ฆใ‚ถ๏ผˆใจAPIใ‚ญใƒผ๏ผ‰ใ ใ‘ใงๅ‹•ใใ€่ปฝ้‡LLMใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ้–‹็™บใƒ„ใƒผใƒซ

flomojiใฏใ€่ค‡้›‘ใช็’ฐๅขƒๆง‹็ฏ‰ใชใ—ใซAIใจใฎๅฏพ่ฉฑใ‚„ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ่‡ชๅ‹•ๅŒ–ใ‚’ๅฎŸ็พใ™ใ‚‹่ปฝ้‡ใƒ„ใƒผใƒซใงใ™ใ€‚ OpenAIใ€Anthropicใ€ใƒญใƒผใ‚ซใƒซLLMใชใฉๆง˜ใ€…ใชAIใƒ—ใƒญใƒใ‚คใƒ€ใƒผใซๅฏพๅฟœใ—ใ€ใƒ—ใƒญใƒณใƒ—ใƒˆใƒใ‚งใƒผใƒณใซใ‚ˆใ‚‹ๅคšๆฎต้šŽๅ‡ฆ็†ใงไฝœๆฅญใ‚’ๅŠน็އๅŒ–ใงใใพใ™ใ€‚

โœจ Features (็‰นๅพด)

  • ๐Ÿš€ Browser-only: No installation required, runs directly in your browser.
  • ๐Ÿ’ฌ AI Chat: Real-time conversations with AI, with chat history management.
  • ๐Ÿ”— Workflows: Automate tasks using prompt chaining.
  • โš™๏ธ JavaScript Code Execution: Secure in-browser JavaScript processing with Web Worker isolation and built-in templates.
  • ๐ŸŒ Web Integration: HTTP requests, web search, and Web API connector for dynamic data processing.
  • โฐ Scheduled Workflows: Automate workflows with cron-based scheduling.
  • ๐ŸŽจ Enhanced Node UI: Color-coded handles and toggleable labels for better visual clarity.
  • ๐Ÿ”Œ Multi-LLM Support: Works with OpenAI, Anthropic, and local LLMs.
  • ๐Ÿ“Š Data Management: Easily manage and export your data.

๐Ÿ“ธ Screenshots

flomoji Workflow Interface

Visual workflow builder with node-based interface for creating AI-powered automation workflows.

๐Ÿš€ Quick Start (ๅˆฉ็”จๆ–นๆณ•)

๐ŸŒ Try Online (ใ‚ชใƒณใƒฉใ‚คใƒณใง่ฉฆใ™)

Instant access: ๐Ÿ‘‰ Launch flomoji - No download required!

๐Ÿ“ฅ Download for Offline Use

The easiest way to use flomoji locally is directly in your browser without any setup.

  1. Download: Click here to download the latest version.
  2. Unzip: Extract the downloaded ZIP file.
  3. Open: Open the index.html file in your web browser (like Chrome, Firefox, or Edge).

That's it! You can start using the application immediately.

๐Ÿ“ How to Use (ไธปใชๆฉŸ่ƒฝ)

Core Features

  • Settings (่จญๅฎš): Choose your LLM provider (like OpenAI) and enter your API key or endpoint. Test the connection to make sure it's working.
  • Chat (ใƒใƒฃใƒƒใƒˆ): Start a conversation with the AI. Your chat history is saved automatically.
  • Workflow (ใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผ): Define a series of prompts to automate a complex task. Input your data, select a workflow, and run it.
  • Data (ใƒ‡ใƒผใ‚ฟ): View, export, or back up your conversation history and other data.

Advanced Node Types

  • โš™๏ธ JavaScript Code Execution: Process data with custom JavaScript code in a secure sandboxed environment
    • Built-in templates for JSON filtering, text processing, data aggregation
    • Web Worker isolation for security and performance
    • 5-second timeout protection and memory limits
  • ๐ŸŒ Web Integration Nodes:
    • HTTP Request Node: Make API calls with customizable headers and methods
    • Web Search Node: Search Google, Brave, or Bing directly from your workflows
  • ๐Ÿ”„ Control Flow: If/While conditions, variable management, and scheduled execution
  • ๐Ÿ“„ Structured Data Extraction: Extract and validate JSON-schema compliant data from unstructured text
    • Rule-based extraction with regex patterns
    • LLM-based extraction with automatic prompt generation
    • Schema validation and automatic data repair

Structured Extraction Workflow Example

The Structured Extraction feature uses a two-node pattern to extract and validate data:

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”     โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”     โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”     โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Input Node   โ”‚โ”€โ”€โ”€โ”€โ–ถโ”‚Structuredโ”‚โ”€โ”€โ”€โ”€โ–ถโ”‚   LLM Node      โ”‚โ”€โ”€โ”€โ”€โ–ถโ”‚   Schema   โ”‚
โ”‚ (Text Data)  โ”‚     โ”‚Extractionโ”‚     โ”‚ (Process Prompt)โ”‚     โ”‚ Validator  โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜     โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜     โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜     โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                           โ”‚                                          โ”‚
                           โ–ผ                                          โ–ผ
                     (Direct output                            (Validated JSON)
                      if rules match)

How it works:

  1. Structured Extraction Node attempts rule-based extraction first
  2. If rules fail or in LLM mode, it generates a prompt for the LLM
  3. LLM Node processes the prompt and returns JSON
  4. Schema Validator Node validates and optionally repairs the JSON

This DAG-compliant pattern ensures clean data flow without cycles. See Structured Extraction Guide for detailed documentation.

๐Ÿง‘โ€๐Ÿ’ป For Developers (้–‹็™บ่€…ๅ‘ใ‘)

If you want to run the app locally or contribute to development:

Run locally:

# Install dependencies
pnpm install

# Start the development server
pnpm run dev

Then, open http://localhost:5173 in your browser.

Build for production:

# Create a production build
pnpm run build

The output files will be in the dist folder. You can deploy this folder to any static hosting service.

External Execution (ๅค–้ƒจใ‹ใ‚‰ใฎๅฎŸ่กŒ)

You can programmatically run any workflow from an external script or your browser's developer console using the runFlomojiWorkflow global function.

Usage:

runFlomojiWorkflow(workflowId, inputData)
  .then(result => {
    console.log('Workflow completed successfully:', result);
  })
  .catch(error => {
    console.error('Workflow execution failed:', error);
  });

Parameters:

  • workflowId (string): The ID of the workflow you want to run. You can find the ID in the workflow management screen.
  • inputData (object, optional): An object containing the initial input data for the workflow. Defaults to an empty object.

Example:

To run a workflow with the ID my-awesome-workflow and provide it with some initial data, open your browser's developer console and enter:

runFlomojiWorkflow('my-awesome-workflow', {
  userInput: 'This is a test message from the console.'
});

This will execute the workflow and print the final output variables to the console upon completion.

๐Ÿš€ CI/CD Automation

This repository includes automated CI/CD workflows using GitHub Actions:

Pull Request Workflow

  • Quality Checks: Automatic linting, testing, and building on every PR
  • Auto Review: Comments with quality check results
  • Auto Merge: Approved PRs are automatically merged after passing all checks

Deployment Workflow

  • Automatic Deployment: Every merge to main triggers automatic deployment to GitHub Pages
  • Build & Test: Ensures all tests pass before deployment
  • Live Updates: Changes are automatically reflected at https://hama-jp.github.io/flomoji/

Contributing

  1. Create a feature branch from main
  2. Make your changes and commit
  3. Create a Pull Request
  4. The CI system will automatically run quality checks
  5. Once approved, the PR will be auto-merged and deployed

๐Ÿ” Security (ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ)

  • Your API keys are stored only in your browser's LocalStorage.
  • All data processing happens on the client-side (in your browser).
  • No data is ever sent to or stored on a server.
  • JavaScript code execution is sandboxed using Web Workers with restricted global access.
  • Timeout protection prevents infinite loops and resource exhaustion.

๐Ÿ“„ License (ใƒฉใ‚คใ‚ปใƒณใ‚น)

This project is licensed under the Apache 2.0 License.

โค๏ธ Support (ใ‚ตใƒใƒผใƒˆ)

If you have any issues or feature requests, please open an issue on GitHub.

About

๐ŸŒŠ flomoji - Visual LLM workflow builder for everyone

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0