To get started with AkashCLI, your users should follow these steps. You can provide this guide as a README.md or a "Getting Started" message in your bot.
🚀 Akash Vault: Getting Started Guide
AkashCLI is the professional command-line interface and SDK for interacting with your E2E encrypted vault. Follow these steps to install and secure your first files.
1. Prerequisites
Ensure you have Python 3.10+ and pip installed on your machine (Linux, Termux, Mac, or Windows).
2. Installation
Since this is a custom package, users can install it directly from your source code or repository:
# Clone the repository
git clone https://github.com/juniorsir/akashcli
cd akashcli
# Install in editable mode
pip install . --break-system-packages
3. First-Time Setup (Authentication)
Before using the vault, you must link your device using an API Key generated from the Akash Telegram Bot.
- Open the Bot and go to 👤 My Account -> 🔑 Generate API Key.
- In your terminal, run:
akash login - Enter your API Key when prompted. Your key will be encrypted and bound to your hardware automatically.
4. Daily Workflow Commands
📤 Uploading Content
Upload a file:
akash upload movie.mp4
Upload a secret text snippet:
akash upload --text "My secret server password is 1234" --name "passwords.txt"
Upload with security flags:
# Delete automatically after the first person views it
akash upload --burn secret_doc.pdf
# Set a 7-day expiry
akash upload --expiry 7 data_backup.zip
📦 Managing the Vault
List your most recent files:
akash files
Get file details or secure links:
akash stream FILE_CODE
Delete a file permanently:
akash delete FILE_CODE
5. Professional Features
🚀 Bulk Vaulting
Vault an entire folder of documents or images at once:
akash bulk ./my_documents_folder
🎬 Native Streaming
Stream a vaulted video directly into VLC Media Player without downloading:
akash stream FILE_CODE --vlc
📊 System Health
Check your remaining quota and vault status:
akash admin
6. Using the SDK (For Developers)
If you are building your own Python scripts, you can import the library directly:
from akashcli import AkashClient
# Initialize client (uses your encrypted local config)
client = AkashClient()
# Vault a log file
result = client.upload_file("system.log", expiry=30)
print(f"File secured! Access it at: {result.embed_url}")
# List all your files programmatically
for file in client.list_files():
print(f"{file.name} -> {file.code}")
💡 Troubleshooting
- Access Denied? Ensure you have set your API Key domains to
*in the Telegram Bot under "Edit Domains." - VLC not opening? Ensure the
vlccommand is available in your system's PATH. - Forgot your key? Run
akash loginagain to overwrite the old session.
🛡️ Powered by Akash Enterprise Core.
1 maintainer
Metadata
1 maintainer
Release files for akashcli 4.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| akashcli-4.5.0.tar.gz | 68.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| akashcli-4.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 143.5 kB
Release files / akashcli-4.5.0.tar.gz
| Download URL | akashcli-4.5.0.tar.gz |
|---|---|
| Size | 68.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2093c0023e882342e22de7c935358d5137739014f23f46961b9222612fea6bd1
|
|
BLAKE2b-256 checksum How to use checksums |
38ade0d7bab485ed1f07bde357abcd277797bba6b5f90cc5b4baa5ce1135fd11
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / akashcli-4.5.0-py3-none-any.whl
| Download URL | akashcli-4.5.0-py3-none-any.whl |
|---|---|
| Size | 75.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6aedb66e34c99ea7046bd60432e11ad3544fde1b9b5afefa0a3ae366b6cbd24d
|
|
BLAKE2b-256 checksum How to use checksums |
9e09473b7bb4e99461706b915f96db03bbb8e6e57a77dc93a60e3dc7197be961
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Security for akashcli 4.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
