Documentation
Simple, free secret storage that doesn't suck
Quick Start
Get started with Vior Secrets in under 5 minutes. No credit card required, no enterprise sales calls.
1. Create Account
Sign up for free - seriously, it's actually free.
2. Get Your Secret Credentials
Generate your API key from the dashboard.
3. Start Storing Secrets
Use our SDKs or CLI to store and retrieve secrets.
Python SDK
Easy secret management for Python applications. Works on Windows, Linux, and macOS.
Requirements
Python: >= 3.7
Make sure Python is installed and accessible from your command line.
Installation for macOS
For macOS users, we recommend using pipx for CLI installation:
1. Install Homebrew (if you don't have it):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. Install pipx:
brew install pipx
3. Configure your PATH (if it hasn't been configured):
pipx ensurepath
4. Install vior-cli:
pipx install vior-cli
5. Install the SDK (same for all platforms):
pip install vior-sdk
Note: This method is specifically for macOS. Windows and Linux users can use the standard pip installation method below. This process is only for the CLI tool - the SDK installation remains the same for all platforms.
Installation for Windows/Linux
For Windows and Linux users, use the standard pip installation:
Install the CLI tool for configuration:
pip install vior-cli
Install the SDK for your applications:
pip install vior-sdk
Quick Usage
Now you can use vior in your CLI. Configure your credentials and start storing secrets:
# In your Python code
from vior import secrets
client = secrets.Client()
secret = client.get_secret("my_secret")Node.js SDK
🚧 Coming Soon
We're working hard to bring you a seamless Node.js experience. Stay tuned!
Go SDK
🚧 Coming Soon
Go developers, we haven't forgotten about you! Our Go SDK is in development.
CLI Configuration
After installing the CLI and SDK packages, you'll need to configure your credentials to start using Vior Secrets.
Setting Up Your Credentials
Open your terminal (Command Prompt or PowerShell on Windows) and run the configure command:
vior configure
After running this command, you'll see prompts like this:
Secret Access Key:
Secret Private Key: Simply paste your Secret Access Key and Secret Private Key when prompted. Make sure these credentials are valid - you can get them from your dashboard after creating an account.
✓ Success! Once configured successfully, you're all set to start using Vior Secrets in your applications.
Useful CLI Commands
Here are some handy commands to help you manage your Vior Secrets configuration:
Check Configuration Status
View your current configuration including secrets path and server URL:
vior status
Manage Server Settings
View or change the server URL (only change if you have your own hosted server):
vior server
Get Help
See all available commands and options:
vior --help
Check Version
Make sure you're running the latest version to avoid compatibility issues between SDK and CLI:
vior --version
Clear Credentials
Remove stored credentials from your system:
vior clear
⚠️ Caution! Be careful before running this command. It will break the functionality of any existing codebase that's using Vior Secrets until you reconfigure your credentials.
Common Errors
Running into issues? Here are solutions to the most common problems:
1. CLI Not Found
Error:
vior-cli not found on your system.
Solution:
Install the CLI using pip:
pip install vior-cli
For macOS users:
Ensure pipx is installed and in PATH. If not, run:
brew install pipx
pipx ensurepath
pipx install vior-cli
2. Authentication Error
Error:
No configuration found on your system.
Solution:
Configure your credentials using:
vior configure
Need credentials?
Get your Secret Access Key and Secret Private Key from: https://secrets.viorcloud.com
That's All, Folks! 🎉
Congratulations! You're now officially smarter than everyone still paying AWS hundreds of dollars for secret storage.
If you run into any issues, remember: it's probably not our fault. But we'll help you anyway because we're nice like that.
Now go forth and store secrets like the champion you are! 🏆