Creating Your First Naptha User Account
What is a Naptha User Account?
Your Naptha account is your identity on the Naptha platform. It allows you to:
- Deploy and manage agents, tools, environments and other modules on the Naptha Hub
- Access and interact with the Naptha Hub's features and services
This guide will walk you through the process of creating your first Naptha user account step by step.
Prerequisites
Before we begin, ensure you have:
- Python 3.8 or higher installed
- Poetry package manager (
pipx install poetry
) - Basic familiarity with command line tools
- Git installed
1. Getting Started
Install the SDK
First, clone and install the Naptha SDK:
git clone https://github.com/NapthaAI/naptha-sdk.git
cd naptha-sdk
poetry install
poetry shell
cp .env.example .env #set up your environment variables
2. Creating Your Account
You have two methods to choose from:
Method 1: Interactive Signup (Recommended)
The simplest way to create a new account is through the interactive CLI. Run the following command:
naptha signup
This will:
- Guide you through username/password creation
- Generate your cryptographic public/private keypair
- Automatically save your credentials to the .env file
Method 2: Pre-configured Setup
If you prefer setting credentials beforehand:
-
Edit your
.env
file with your desired credentials:# .env file
HUB_USERNAME=your_username
HUB_PASSWORD=your_password
PRIVATE_KEY=your_private_key # Optional - will be generated if not provided -
Run signup:
naptha signup
3. Verifying Your Setup
Check Available Nodes
naptha nodes
Try a Sample Agent
naptha run agent:hello_world_agent -p "firstname=sam surname=altman"
Verify Programmatically
You can also verify the new credentials programmatically via the client SDK:
from naptha_sdk.client.naptha import Naptha
async def verify_credentials():
try:
async with Naptha() as naptha:
await naptha.hub.signin(os.getenv("HUB_USERNAME"), os.getenv("HUB_PASSWORD"))
return True
except Exception as e:
print(f"Credential verification failed: {str(e)}")
return False
4. Best Practices
Security
-
Protect Your Private Key
- Never share your private key
- Back up your
.env
file - Use environment variables in production
-
Password Guidelines
- Use strong passwords (12+ characters)
- Mix uppercase, lowercase, numbers, symbols
- Avoid common words or patterns
Maintenance
- Keep the SDK updated by fetching the latest version from GitHub or PyPI
- Review registered agents periodically
Troubleshooting
Connection Issues
If you're having trouble connecting:
-
Check your node URL in
.env
:# Local node
NODE_URL=http://localhost:7001
# Hosted node
NODE_URL=http://node.naptha.ai:7001 -
Verify credentials:
cat .env
Authentication Issues
If you're having trouble authenticating:
-
Ensure correct credentials in
.env
-
Try creating a new account with a different username and password and re-run the signup command:
naptha signup
Next Steps
Once your account is set up, you can:
- Explore available agents:
naptha agents
- Create your own agent:
- Clone the base template
- Follow the template instructions for prototyping, testing and deploying your agent
You can also follow our Quick Guide to Creating and Publishing Your First Agent Module on Naptha to create your own agent.
Need Help?
- Join our Discord Community
- Follow us on Twitter
- Join us on Farcaster
- Get help with technical issues on GitHub