Home

Awesome

FlowTestAI: Streamlining End-to-End API Testing

Release Notes Linkedin Twitter Follow Chat on Discord

💡 We are proud to announce that we were recently featured in a LangChain blog post.

FlowTestAI is a powerful, code-agnostic tool designed to simplify the creation and execution of end-to-end API tests. With its intuitive interface and robust features, FlowTestAI empowers developers and QA teams to streamline their API testing process, improve collaboration, and gain valuable insights into their API performance.

<img width="1728" alt="Screenshot 2024-04-18 at 5 41 43 PM" src="https://github.com/FlowTestAI/FlowTest/assets/5829490/c04f6e3e-fe69-4d25-a008-ba558c8fe149">

🚀 Key Features

🛠️ Getting Started

Desktop App Installation

  1. Download FlowTestAI for your OS from our releases page.
  2. Install and launch FlowTestAI like any other desktop application.
  3. Start creating end-to-end API tests using natural language or drag-and-drop.
  4. Save your work locally and use Git for version control, just like with traditional IDEs.

CLI Installation (for CI/CD)

npm install -g flowtestai

https://www.npmjs.com/package/flowtestai

The CLI allows you to run flows created using FlowTestAI from command line interface making it easier to automate and run them in a CI/CD (continuous integration/development) fashion.

README

Analytics Setup (Optional)

  1. Visit https://www.useflowtest.ai/
  2. Go to Products -> Analytics -> Get Access Key Pairs
  3. For CLI: Export key pairs as environment variables
  4. For IDE: Open Settings and paste the access key pairs
  5. Now start publishing scans for each test run.

📚 Documentation

https://flowtestai.gitbook.io/flowtestai

Setup

💻 Production

FlowTestAI is an electron app that runs entirely in your local environment interacting with your local file system just like other IDE(s) out there like VSCode, Intellij etc. The platform-specific binaries are available for download from our GitHub releases. We currently offer binaries for macOS, with versions for Windows and Linux under development 🚧. If you require a binary for a specific platform, please let us know in the Discussions section. We will prioritize your request accordingly.

🔧 Development

Prerequisite

This package uses version >= 18 of Node.js. There are different ways that you can install Node.js, following are steps for Node Verson Manager or NVM. If you need steps for other methods than NVM then please check Official Node.js documentation. Here is a sample walkthrough installing version 18.

  1. Installs nvm (Node Version Manager)

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
    
  2. Download and install Node.js

    nvm install 18
    
  3. Verifies the right Node.js version is in the environment

    node -v # should print `v18.20.2`
    
  4. Verifies the right NPM version is in the environment

    npm -v # should print `10.5.0`
    

Main setup

  1. Clone the repository

    git clone https://github.com/FlowTestAI/FlowTest.git
    
  2. Go into repository folder

    cd FlowTest
    
  3. This project uses pnpm. Use corepack to enable the required pnpm version:

    corepack enable pnpm
    

    or install with npm

    npm install -g pnpm@9.0.6
    
  4. Install all project dependencies:

    pnpm install
    
  5. Build and start the app:

    pnpm start
    

    The app should start as a normal desktop app

    NOTE: if you use npm and corepack to install pnpm you will have two instances of pnpm. Make sure the version you're using is the correct version for the repo. Check the pnpm docs and corepack for troubleshooting. Pnpm installed with npm will overrun corepacks pnpm instance.

🤝 Contribution

"Little drops of water make a mighty ocean"

No contribution is small even if it means fixing a spelling mistake. Follow our contributing guide below. https://github.com/FlowTestAI/FlowTest/blob/main/CONTRIBUTING.md

Fun fact: our contributing guide itself was an external contribution 🍺

🌟 Support

📜 License

Source code in this repository is made available under the MIT License.

Connect with Us