{"id":22480231,"url":"https://github.com/pinatacloud/pinata-go-cli","last_synced_at":"2025-08-02T14:32:54.282Z","repository":{"id":217403675,"uuid":"743782547","full_name":"PinataCloud/pinata-go-cli","owner":"PinataCloud","description":"The Pinata CLI written in Go","archived":false,"fork":false,"pushed_at":"2024-09-09T14:11:11.000Z","size":17,"stargazers_count":8,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-30T16:04:55.291Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PinataCloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-16T01:21:52.000Z","updated_at":"2024-10-26T18:48:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"ef1bac75-62be-4e1d-a28c-d7580cec67bc","html_url":"https://github.com/PinataCloud/pinata-go-cli","commit_stats":null,"previous_names":["pinatacloud/pinata-go-cli"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PinataCloud%2Fpinata-go-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PinataCloud%2Fpinata-go-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PinataCloud%2Fpinata-go-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PinataCloud%2Fpinata-go-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PinataCloud","download_url":"https://codeload.github.com/PinataCloud/pinata-go-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228483517,"owners_count":17927363,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-06T15:20:11.430Z","updated_at":"2025-08-02T14:32:54.272Z","avatar_url":"https://github.com/PinataCloud.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pinata Go CLI (Deprecated)\n\n\u003e [!WARNING]\n\u003e This CLI has been deprecated for a new version that supports both Public and Private IPFS: [https://github.com/PinataCloud/ipfs-cli](https://github.com/PinataCloud/ipfs-cli)\n\n## Installation\n\n### Install Script\n\nThe easiest way to install is to copy and paste this script into your terminal\n\n```bash\ncurl -fsSL https://cli.pinata.cloud/install-web3 | bash\n```\n\n### Building from Source\n\nTo build and instal from source make sure you have [Go](https://go.dev/) installed on your computer and the following command returns a version:\n\n```\ngo version\n```\n\nThen paste and run the following into your terminal:\n\n```\ngit clone https://github.com/PinataCloud/pinata-go-cli \u0026\u0026 cd pinata-go-cli \u0026\u0026 go install .\n```\n\n### Linux Binary\n\nAs versions are released you can visit the [Releases](https://github.com/PinataCloud/pinata-go-cli/releases) page and download the appropriate binary for your system, them move it into your bin folder.\n\nFor example, this is how I install the CLI for my Raspberry Pi\n\n```\nwget https://github.com/PinataCloud/pinata-go-cli/releases/download/v0.1.2/pinata-go-cli_Linux_arm64.tar.gz\n\ntar -xzf files-cli_Linux_arm64.tar.gz\n\nsudo mv pinata /usr/bin\n```\n\n## Usage\n\nThe Pinata CLI is equipped with the majortiry of features on the Pinata API.\n\n### `auth` - Authentication\n\nWith the CLI installed you will first need to authenticate it with your [Pinata JWT](https://docs.pinata.cloud/docs/api-keys)\n\n```shell\npinata-web3 auth \u003cyour-jwt\u003e\n```\n\n### `upload` - Uploads\n\nAfter authentication you can now upload using the `upload` command or `u` for short, then pass in the path to the file or folder you want to upload.\n\n```shell\npinata-web3 upload ~/Pictures/somefolder/image.png\n```\n\nThe following flags are also available to set the name or CID version of the upload.\n\n```shell\n--version value, -v value  Set desired CID version to either 0 or 1. Default is 1. (default: 1)\n--name value, -n value     Add a name for the file you are uploading. By default it will use the filename on your system. (default: \"nil\")\n--cid-only                 Use if you only want the CID returned after an upload (default: false)\n\n```\n\n### `list` - List Files\n\nYou can list files with the `list` command or the alias `l`. The results are printed in raw JSON to help increase composability.\n\n```shell\npinata-web3 list\n```\n\nBy default it will retrieve the 10 latest files, but with the flags below you can get more results or fine tune your search.\n\n```shell\n--cid value, -c value         Search files by CID (default: \"null\")\n--amount value, -a value      The number of files you would like to return, default 10 max 1000 (default: \"10\")\n--name value, -n value        The name of the file (default: \"null\")\n--status value, -s value      Status of the file. Options are 'pinned', 'unpinned', or 'all'. Default: 'pinned' (default: \"pinned\")\n--pageOffset value, -p value  Allows you to paginate through files. If your file amount is 10, then you could set the pageOffset to '10' to see the next 10 files. (default: \"null\")\n```\n\n### `delete` - Delete Files\n\nIf you ever need to you can delete a file by CID using the `delete` command or alias `d` followed by the file CID.\n\n```shell\npinata-web3 delete QmVLwvmGehsrNEvhcCnnsw5RQNseohgEkFNN1848zNzdng\n```\n\n### `pin` - Pin by CID\n\nSeparate from the `upload` command which uploads files from your machine to Pinata, you can also pin a file already on the IPFS network by using the `pin` command or alias `p` followed by the CID. This will start a pin by CID request which will go into a queue.\n\n```shell\npinata-web3 pin QmVLwvmGehsrNEvhcCnnsw5RQNseohgEkFNN1848zNzdng\n```\n\nTo check the queue use the `request` command.\n\n### `requests` - Pin by CID Requests\n\nAs mentioned in the `pin` command, when you submit an existing CID on IPFS to be pinned to your Pinata account, it goes into a request queue. From here it will go through multiple status'. For more info on these please consult the [documentation](https://docs.pinata.cloud/reference/get_pinning-pinjobs).\n\n```shell\npinata-web3 requests\n```\n\nYou can use flags to help filter requests as well.\n\n```shell\n--cid value, -c value         Search pin by CID requests by CID (default: \"null\")\n--status value, -s value      Search by status for pin by CID requests. See https://docs.pinata.cloud/reference/get_pinning-pinjobs for more info. (default: \"null\")\n--pageOffset value, -p value  Allows you to paginate through requests by number of requests. (default: \"null\")\n```\n\n## Contact\n\nIf you have any questions please feel free to reach out to us!\n\n[team@pinata.cloud](mailto:team@pinata.cloud)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinatacloud%2Fpinata-go-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpinatacloud%2Fpinata-go-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinatacloud%2Fpinata-go-cli/lists"}