Welcome to Abstra

👋🏼 Abstra helps you build and automate business processes faster using Python.

It consists of two main parts:

• 🧩 Abstra Editor: A local development environment to build and test workflows.
• ☁️ Abstra Cloud: A cloud environment to host, monitor, and manage your production workflows.

Abstra Editor

Build and test locally using one of the following methods. They all provide the same core editor experience.

Windows

• Install via the Windows Store.
• On first launch, select a folder to create a new project or open an existing one.
• When first launched, the editor will prompt you to select or create a Organization and a project on the cloud to link to.

MacOS & Linux

• Install Abstra: Open your terminal and run pip install abstra (or pip3 install abstra).
• Navigate to your project directory:
  • Use cd <folder_path> (e.g., cd ~/Documents/my-project). Ensure the folder exists.
  • MacOS Tip: Right-click folder -> Services -> Open in Terminal.
• Launch the Editor: Run abstra editor.
• When first launched, the editor will prompt you to select or create a Organization and a project on the cloud to link to.

Python Requirements

• Ensure Python 3.8+ is installed (python3 --version or python --version).
• Download from python.org if needed. Restart your terminal after installation.
• Advanced: macOS users can also use Homebrew.

Web Editor

• Develop directly in the cloud, no local setup required. Ideal for quick edits or cloud-native development.
• Currently in Beta: Does not yet support Git integration or opening projects in local IDEs (like VS Code).

1. Sign up or log in to Abstra Cloud.
2. Ensure you have an Organization and a Project.
3. Select Web Editor from the side menu within your project screen.

Abstra Cloud

The Abstra Cloud Console is where you manage production workflows:

• Deploy projects built with the Editor.
• Monitor execution logs and workflow stages.
• Configure project settings.

Projects reside within Folders, which are contained within your Organization (Organization -> Folder -> Project).

Inviting Teammates

Add teamayes to collaborate on projects:

1. Go to Organization > Editors in the Cloud Console.
2. Click Invite Editors to add them to your Organization.
3. Grant access to specific Folders via the Folder's Settings icon (under the Projects tab). Editors only see Folders they have access to.