# Python

> For AI agents: the complete documentation index is at https://buddy.works/llms.txt

Learn how to build and deploy Python application and run DB migrations.

> **Info**
>
> 📚 Learn more about Python action [features](https://buddy.works/actions/python), [integrations](https://buddy.works/actions/python/integrations) and [alternatives](https://buddy.works/actions/python/alternatives).

With Buddy, you can create a pipeline that builds, tests, and deploys Python applications on a push to Git. The configuration is super simple and takes 10 to 15 minutes.

![Python pipeline example](https://buddy.works/docs/quickstart/python/python-1.png)

Configuration is very easy and takes only a couple of minutes.

## 1. Create a new project

Go to **Projects** and click **Create new project**. Select your Git hosting provider (Buddy, GitHub, Bitbucket, GitLab, or Private Server) and enter your project name.

![Create new project](https://buddy.works/docs/_global/create-new-project.png)

## 2. Add a new pipeline

Navigate to **Pipelines** and click **New pipeline**. In the form, configure the following:

- **Name** - Enter a descriptive name for your pipeline (e.g., "Deploy to production")
- **ID** - Optional identifier for the pipeline
- **CPU** - Select architecture: **x64** or **ARM64**
- **Resources per pipeline run** - Choose resource allocation (default: Workspace default)
- **[Definition Location](https://buddy.works/docs/pipelines/introduction/advanced-settings.md#definition-location)** - Optionally check "Store configuration in a Git repository" to use YAML files

Click **Add pipeline** to create it.

![Add new pipeline](https://buddy.works/docs/_global/add-new-pipeline.png)

## 3. Configure workflow: contexts and triggers

After creating the pipeline, go to the **Workflow** tab to configure:

![Configure Workflow](https://buddy.works/docs/_global/configure-workflow.png)

* **Contexts** - Click `+` to add Git branch/tag context or Environment. See [Contexts](https://buddy.works/docs/pipelines/introduction/contexts.md).

* **Triggers** - Click `+` to add Git events, Schedule, or Webhook. See [Workflow Configuration](https://buddy.works/docs/pipelines/introduction/creating-pipeline/workflow-configuration.md).


## 4. Add actions

Buddy lets you choose from dozens of predefined actions. In this example, we'll add 4 actions that will perform the following tasks:

* Build and test your Python application
* Upload application to server
* Run db migrations & restart application
* Send notification to Slack

### 4.1 Build and test your Python app

> **Success**
>
> Build actions in Buddy are run in isolated containers run from official Docker images. When the pipeline is run, Buddy pulls the container, runs build commands, and uploads the results to the pipeline filesystem.

Look up and click **Python** on the action list to add it to the pipeline: 

![Action list](https://buddy.works/docs/quickstart/python/python-2.png)

The Run tab lets you determine the commands to execute. The default commands are:

```bash
pip install -r requirements.txt
nosetests
```
![Default Python build commands](https://buddy.works/docs/quickstart/python/python-3.png)

#### 4.1.2 Python version

You can change the version of Python and install missing packages & tools in the runtime environment tab:

![Python action image](https://buddy.works/docs/quickstart/python/python-4.png)

> **Tip**
>
> If your tests require a database to run, you can [attach it in the Services](https://buddy.works/docs/actions/services-and-databases/predefined.md) tab:
>
> ![Services tab](https://buddy.works/docs/quickstart/python/python-5.png)

### 4.2 Deploy application to server

The compiled application needs to be uploaded to the server. Head to the **Deploy** tab and select your upload action (Transfer in our case, where you can choose SFTP Target):

![File transfer actions](https://buddy.works/docs/_global/transfer-actions-sftp.png)

When adding the action you can choose what and where should be uploaded:

![SFTP action configuration](https://buddy.works/docs/_global/sftp-target-tab.png)

> **Info**
>
> [Targets](https://buddy.works/docs/targets/introduction.md) allow to save pre-configured transfer server settings to be used across multiple actions.

### 4.3 Run db migrations & restart application

Once the app is deployed, you can run additional commands on your server with the **SSH** action:

![SSH action selection](https://buddy.works/docs/_global/add-ssh-action.png)

Enter the commands to execute in Run CMDs and configure authentication details in the Target tab:

![Application restart command](https://buddy.works/docs/_global/ssh-restart-app.png)

### 4.4 Send notification to Slack

You can configure Buddy to send your team a message after the deployment. In this example we'll use **Slack**:

![Notification actions](https://buddy.works/docs/_global/add-slack-notification.png)

> **Info**
>
> If you add this action in the On Failure tab, Buddy will only send the message if something goes wrong with your build or deployment.
>
> ![On failure notification](https://buddy.works/docs/_global/slack-on-failure.png)

## 5. Summary

**Congratulations!** You have just automated your entire delivery process. Make a push to the selected branch and watch Buddy fetch, build, and deploy your project. With Continuous Delivery applied, you can now focus on what's really important: developing awesome apps! 🔥

> **Success**
>
> Bear in mind that this article is only a brief example of what Buddy can do. You can create additional pipelines for staging and production environments, integrate with your favorite services \(AWS, Google, Azure\), trigger tests on pull requests, build Docker images, and push them to the registry—the possibilities are unlimited.

> **Tip**
>
> If you want us to create a delivery pipeline for your project, drop a line to [support@buddy.works](mailto:support@buddy.works) – we'll be happy to help!


---
Original source: https://buddy.works/docs/basics/workflows/python