1 <!-- LOGO -->
2 <h1>
3 <p align="center">
4 <img src="https://avatars.githubusercontent.com/u/89791739?s=200&v=4" alt="smbCloud Logo" width="128">
5 <br>smbCloud CLI
6 </h1>
7 <p align="center">
8 Deploy with smbCloud from your terminal.
9 <br />
10 <br />
11 <a href="https://smbcloud.xyz/">Website</a>
12 ·
13 <a href="https://smbcloud.xyz/posts">Documentation</a>
14 ·
15 <a href="https://github.com/smbcloudXYZ/smbcloud-cli/releases">Releases</a>
16 ·
17 <a href="https://github.com/smbcloudXYZ/smbcloud-cli/issues">Issues</a>
18 </p>
19 <p align="center">
20 <a href="https://crates.io/crates/smbcloud-cli"><img alt="Crates.io" src="https://img.shields.io/crates/v/smbcloud-cli"></a>
21 <a href="https://www.npmjs.com/package/@smbcloud/cli"><img alt="npm" src="https://img.shields.io/npm/v/@smbcloud/cli"></a>
22 <a href="https://www.nuget.org/packages/SmbCloud.Cli"><img alt="NuGet" src="https://img.shields.io/nuget/v/SmbCloud.Cli"></a>
23 <a href="https://github.com/smbcloudXYZ/homebrew-tap"><img alt="Homebrew" src="https://img.shields.io/badge/homebrew-tap-orange?logo=homebrew"></a>
24 <a href="https://pypi.org/project/smbcloud-cli/"><img alt="PyPI" src="https://img.shields.io/pypi/v/smbcloud-cli"></a>
25 <a href="https://github.com/smbcloudXYZ/smbcloud-cli/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/smbcloudXYZ/smbcloud-cli"></a>
26 </p>
27 </p>
28
29 ## About
30
31 **`smb`** is the command-line interface for [smbCloud](https://smbcloud.xyz/).
32
33 Install it with `pip`, then run the native `smb` binary for your platform.
34
35 ## Install
36
37 ```sh
38 pip install smbcloud-cli
39 ```
40
41 This package installs the native `smb` executable for your platform. You do not need Node.js or Docker.
42
43 ## Quick Start
44
45 ```sh
46 smb login
47 smb init
48 smb deploy
49 ```
50
51 That gets you from login to first deploy.
52
53 ## Other Installation Methods
54
55 ### Homebrew (macOS & Linux)
56
57 ```sh
58 brew tap smbcloudXYZ/tap
59 brew install cli
60 ```
61
62 ### npm
63
64 ```sh
65 npm install -g @smbcloud/cli
66 ```
67
68 ### .NET tool
69
70 ```sh
71 dotnet tool install --global SmbCloud.Cli
72 ```
73
74 ### Shell (macOS / Linux)
75
76 ```sh
77 curl -fsSL https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-unix.sh | sh
78 ```
79
80 ### PowerShell (Windows)
81
82 ```powershell
83 irm https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-windows.sh | iex
84 ```
85
86 Or grab a pre-built binary from the [Releases](https://github.com/smbcloudXYZ/smbcloud-cli/releases) page.
87
88 ## Documentation
89
90 Full documentation is available at [smbcloud.xyz/posts](https://smbcloud.xyz/posts).
91
92 ## Platform Support
93
94 This package ships pre-built native binaries for:
95
96 | Platform | Architecture |
97 | ------------- | ------------ |
98 | macOS | arm64, x64 |
99 | Linux (glibc) | arm64, x64 |
100 | Windows | arm64, x64 |
101
102 ## Source & Issues
103
104 This package ships the native `smb` binary through PyPI.
105 Source code and issue tracker:
106 [github.com/smbcloudXYZ/smbcloud-cli](https://github.com/smbcloudXYZ/smbcloud-cli).
107
108 See the [smbCloud documentation](https://smbcloud.xyz/posts) for setup and deployment guides.
109
110 ## License
111
112 [Apache-2.0](https://github.com/smbcloudXYZ/smbcloud-cli/blob/main/LICENSE)
113
114 ## Copyright
115
116 © 2026 [Splitfire AB](https://5mb.app) ([smbCloud](https://smbcloud.xyz)).