create_project

imerit_ango.sdk.SDK.

create_project(name, description, project_type)

Create a new project in your organization.

Parameters

• name: string

  • The display name of the project to be created. This field is required and cannot be left empty.

  • Example: 'Project One'

• description: string, optional, default ""

  • A brief description of the project.

  • Example: 'Vehicle Classification Project'

• project_type: ProjectType, optional, default None

  • Specifies the type of the project.

  • Options:

    • ProjectType.Ango

    • ProjectType.PCT

    • ProjectType.IFrame

  from imerit_ango.models.enums import ProjectType

Returns:

• output: dict

  • A dictionary containing the result of the operation.

  • Including a status field indicating whether the request was successful and a data field containing the response payload with updated resources produced by the operation.

How to verify in Ango Hub?

After successfully executing the create_project function, you can validate the changes directly in Ango Hub.

Navigate to: Projects

• Confirm that the created project appears in the project list.

Changes made via the SDK are reflected in Ango Hub in near real-time. If updates are not immediately visible, please refresh the page.

Example

Create a standard Ango project:

python

import os
from dotenv import load_dotenv
from imerit_ango.sdk import SDK

load_dotenv('variables.env')
api_key = os.getenv('API_KEY')

ango_sdk = SDK(api_key)

response = ango_sdk.create_project(
    name="New Ango Project",
    description="Created via SDK"
)

project_id = response["data"]["project"]["id"]

curl

curl -X POST "https://imeritapi.ango.ai/v2/project" \
  -H "Content-Type: application/json" \
  -H "apikey: $ANGO_API_KEY" \
  -d '{
    "description": "Created via SDK",
    "name": "New Ango Project"
  }'

Returns

{
    "status": "success",
    "data": {
        "project": {
            "id": "<PROJECT ID>",
            "name": "New Ango Project",
            "type": "ango",
            "pctConfig": {
                "allowOverlapping": false,
                "trackingMultipleSensors": false,
                "segmentationMode": false
            },
            "description": "Created via SDK",
            "createdAt": "<CREATED AT TIME>",
            "categorySchema": {
                "tools": [],
                "classifications": [],
                "relations": []
            },
            "benchmarkEnabled": false,
            "benchmarkRatio": 10,
            "benchmarkCutoff": false,
            "customValidationEnabled": false,
            "submissionPrevent": false,
            "validationFunction": "",
            "externalValidation": {
                "enabled": false,
                "apiUrl": "",
                "singleFrame": false,
                "specificFrame": false
            },
            "organization": "<ORGANIZATION ID>",
            "owner": "<USER EMAIL>",
            "gcSyncEnabled": false,
            "assignedTo": [],
            "deleted": false,
            "ocrLanguage": "eng",
            "idleTimeout": 300,
            "projectPlugins": {},
            "pluginPresets": [],
            "batches": [],
            "errorCodesEnabled": false,
            "errorSchema": {},
            "exportStorageEnabled": false,
            "taskSkipEnabled": true,
            "unassignSkippedTask": false,
            "stages": [
                {
                    "id": "Start",
                    "name": "Start",
                    "type": "Start",
                    "next": [
                        "Label"
                    ],
                    "assignedTo": [],
                    "readOnly": false,
                    "rememberAssignee": true,
                    "position": {
                        "x": 0,
                        "y": 50
                    },
                    "autoForward": true
                },
                {
                    "id": "Complete",
                    "name": "Complete",
                    "type": "Complete",
                    "next": [],
                    "assignedTo": [],
                    "readOnly": false,
                    "rememberAssignee": true,
                    "position": {
                        "x": 600,
                        "y": 78
                    },
                    "autoForward": true
                },
                {
                    "id": "Label",
                    "name": "Label",
                    "type": "Label",
                    "next": [
                        "Complete"
                    ],
                    "assignedTo": [],
                    "readOnly": false,
                    "rememberAssignee": true,
                    "position": {
                        "x": 300,
                        "y": 50
                    },
                    "autoForward": true
                }
            ],
            "assetCount": 0,
            "assetBuilderTemplates": [],
            "_id": "<PROJECT ID>"
        }
    }
}

Create a PCT project:

python

import os
from dotenv import load_dotenv
from imerit_ango.sdk import SDK
from imerit_ango.models.enums import ProjectType

load_dotenv('variables.env')
api_key = os.getenv('API_KEY')

ango_sdk = SDK(api_key)

response = ango_sdk.create_project(
    name="New PCT Project",
    description="Created via SDK",
    project_type=ProjectType.PCT
)

project_id = response["data"]["project"]["id"]

curl

curl -X POST "https://imeritapi.ango.ai/v2/project" \
  -H "Content-Type: application/json" \
  -H "apikey: $ANGO_API_KEY" \
  -d '{
        "description": "Created via SDK",
        "name": "My New PCT Project",
        "type": "pct"
      }'

See also

list_projects, get_project