Package: p8n-importer
p8n-importerOverviewp8n-importeris a versatile dataset import tool designed to simplify the process of importing various dataset formats into the PropulsionAI platform. This tool supports multiple formats, including VOC, YOLO, COCO, Image Classification, and Tabular data, and enables seamless integration with the PropulsionAI ecosystem. The tool now includes enhanced functionalities such as verbose logging and dataset visualization before uploading.Explore more about PropulsionAI atPropulsionHQ.FeaturesMultiple Format Support: Easily import datasets in formats like VOC, YOLO, COCO, Image Classification, and Tabular.Direct Upload: Upload datasets directly to the PropulsionAI platform with an easy-to-use command-line interface.Flexibility: Extendable to support additional dataset formats in the future.Secure API Key Handling: API keys are handled securely via environment variables or interactive input.Verbose Logging: Get detailed logs of the import process with the--verboseoption.Visualization: Preview the dataset conversion result before uploading with the--visualizeoption.InstallationTo install `p8n-importer, you need Python 3.x and pip installed on your system. You can installp8n-importer` directly from PyPI:pipinstallp8n-importerUsageCommand-Line Interfacep8n-importercan be executed from the command line. Here’s how you can use it:p8n-importer[format][source_folder][--verbose][--no-upload][--visualize][format]: The format of your dataset (e.g.,voc,yolov8,coco_json,im_classification,tabular).[source_folder]: Path to the source dataset folder.--verbose(optional): Enable verbose logging for detailed information during the import process.--no-upload(optional): Skip uploading the converted dataset to the platform.--visualize(optional): Visualize the dataset conversion result before uploading.Programmatic Usep8n-importeralso supports being used programmatically as shown in the example below:fromP8nImporterimportP8nImporterimporter=P8nImporter(api_key="YOUR_API_KEY",dataset_id="DATASET_ID",)image="path/to/image.jpg"annotation_path="path/to/annotation.txt"withopen(annotation_path,"r")asf:annotation=f.read()# should be a string (multiline is supported)label_names=["label1","label2"]importer.import_task(format="yolov8",image=image,annotation=annotation,label_names=label_names,)Supported FormatsThe following table lists the formats currently supported byp8n-importer, along with their respective format codes:Format CodeFormatInput(s)Action(s)DescriptionvocVOCImageObject DetectionVisualyolov8YOLOv8ImageObject DetectionYou Only Look Once, version 8coco_jsonCOCO JSONImageObject DetectionCommon Objects in Context, JSON formatim_classificationImage ClassificationImageClassificationGeneric image classification datasetstabularTabularTabularClassification, RegressionDatasets in tabular formats like CSV, Excel, ParquetiamIAMImageCharacter Recognitiontxt file with format "abc.jpg	ABC" on each line. images in "image" folderMore formats are planned for future releases.Visualization Feature (Only supported on CLI)When using the--visualizeflag, you can preview how the dataset will look after conversion. This feature is particularly useful to verify annotations and dataset integrity before uploading it to the PropulsionAI platform.API Key and Dataset IDThe tool will prompt you for the API key and dataset ID. The API key can also be set as an environment variablePROPULSIONAI_API_KEY.ContributingContributions top8n-importerare welcome! If you're looking to contribute, please read ourContributing Guidelines.Licensep8n-importeris available under the MIT license. See theLICENSEfile for more info.ContactFor support or any questions, feel free to contact us atinfo@propulsionhq.com.