Installation & Setup¶
Get IOValence installed and ready in minutes.
System Requirements¶
Before installing, ensure you have:
- Python: 3.8 or higher
- Operating System: Windows, macOS, or Linux
- RAM: Minimum 4GB (8GB+ recommended)
- Disk Space: At least 2GB
Detailed System Requirements →
Installation Methods¶
Method 1: pip (Recommended)¶
pip install iovalence
Verify installation:
iovalence --version
Method 2: conda¶
conda install -c iovalence iovalence
Method 3: From Source¶
git clone https://github.com/IOValence/iovalence.git
cd iovalence
pip install -e .
Post-Installation Setup¶
1. Create Your First Project Directory¶
mkdir my-projects
cd my-projects
2. Initialize IOValence¶
iovalence init --project my-first-project
3. Verify Everything Works¶
iovalence check
You should see:
✓ IOValence installed
✓ Python environment OK
✓ Dependencies satisfied
✓ GPU support available (if applicable)
Configuration¶
Optional: Set API Key¶
If using cloud features:
iovalence config set api-key YOUR_API_KEY
Optional: Set Default Framework¶
iovalence config set framework tensorflow
Options: tensorflow, pytorch, sklearn
Upgrade IOValence¶
To get the latest version:
pip install --upgrade iovalence
Troubleshooting Installation¶
Issue: "command not found: iovalence"¶
Solution: Ensure pip installed to your PATH:
python -m pip install --upgrade iovalence
Issue: Dependency conflicts¶
Solution: Use a fresh virtual environment:
python -m venv iovalence-env
source iovalence-env/bin/activate # On Windows: iovalence-env\Scripts\activate
pip install iovalence
Issue: GPU not detected¶
Solution: Install GPU support separately:
pip install iovalence[gpu]
Virtual Environment (Recommended)¶
Create an isolated environment for IOValence:
# Create virtual environment
python -m venv iovalence-env
# Activate it
# On Linux/macOS:
source iovalence-env/bin/activate
# On Windows:
iovalence-env\Scripts\activate
# Install IOValence
pip install iovalence
Next Steps¶
- 📚 Your First Agent - Build something in 5 minutes
- ⚙️ System Requirements - Check detailed requirements
- 🎯 Quick Start - Learn the basics
Need help? See Troubleshooting → pip install iovalence[dev] ```
Next Steps¶
- 📚 Your First Agent - Build something in 5 minutes
- ⚙️ System Requirements - Check detailed requirements
- 🎯 Learn the Basics - Understand core concepts
Need help? See Troubleshooting →