Page cover image

Installation Guide: Axion Framework

Prerequisites

Before installing the Axion Framework, ensure you have the following tools and software installed:

  1. Python 3.9 or Later

  2. Git

    • Clone the repository using Git. Install from git-scm.com.

  3. Package Manager (pip)

    • Pip comes pre-installed with Python. If it’s missing, you can install it using:

      bashCopy codepython -m ensurepip --upgrade
  4. Redis (for task queues and swarm consensus)

    • Install Redis via:

      bashCopy codesudo apt-get install redis

      Or download it from redis.io.

  5. Database (Optional) Install depending on your project needs:


Step 1: Clone the Repository

Clone the Axion Framework repository:

bashCopy codegit clone https://github.com/<your-organization>/axion-framework.git
cd axion-framework

Step 2: Set Up a Virtual Environment

It’s recommended to use a virtual environment to avoid dependency conflicts:

bashCopy codepython -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Step 3: Install Dependencies

Install the required packages using pip:

bashCopy codepip install -r requirements.txt

Step 4: Configure Environment Variables

Set up your environment variables for blockchain integrations, IPFS, and other services. Create a .env file in the root directory:

bashCopy code# Blockchain
SOLANA_WALLET_PATH=/path/to/solana-wallet.json
ETHEREUM_WALLET_PRIVATE_KEY=your_ethereum_private_key_here

# Redis
REDIS_HOST=localhost
REDIS_PORT=6379

# MongoDB
MONGODB_URI=mongodb://localhost:27017

Step 5: Start Redis

Ensure Redis is running:

bashCopy coderedis-server

Step 6: Run Axion Framework

Launch the framework and start interacting with your decentralized swarm:

bashCopy codepython examples/swarm_simulation.py

Optional: Additional Integrations

  1. MongoDB: Ensure your MongoDB server is running:

    bashCopy codemongod
  2. Neo4j: Start Neo4j from your terminal or GUI:

    bashCopy codeneo4j start
  3. Qdrant: Start Qdrant on your local server or cloud instance.

  4. SQLite: No additional setup is required; SQLite is file-based and ready to use.


Troubleshooting

  • Issue: ModuleNotFoundError

    • Solution: Ensure all dependencies are installed using:

      bashCopy codepip install -r requirements.txt
  • Issue: redis.exceptions.ConnectionError

    • Solution: Confirm that Redis is running on the correct host and port.

  • Issue: FileNotFoundError for wallet paths

    • Solution: Verify the .env file configuration and ensure the file paths are valid.

Last updated