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.5
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.5.tar.gz | 71.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| akashcli-4.5.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 150.8 kB
Release files / akashcli-4.5.5.tar.gz
| Download URL | akashcli-4.5.5.tar.gz |
|---|---|
| Size | 71.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3e1ac0f2e92367485f994229ab14c7f8caf8d03dfd36ec1447b8cb59c8cac225
|
|
BLAKE2b-256 checksum How to use checksums |
341a71a32fbb2d83606a0a456360df2714c1b9a223fa5d592334e109a168543a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / akashcli-4.5.5-py3-none-any.whl
| Download URL | akashcli-4.5.5-py3-none-any.whl |
|---|---|
| Size | 79.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e272501d1dc2870c540d89fed2bcd9d628ff280b50686ae362bf2f6fd8a66857
|
|
BLAKE2b-256 checksum How to use checksums |
7682795d2006dfca9aa702bf79e8139a0cc4e1bc2599d51f4872a9db580744e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Security for akashcli 4.5.5
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.
