# Development Guide

<figure><img src="https://1522519231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FST0HkXZPgoaIsa818gsK%2Fuploads%2Fxvo3VgvuAgVlBz6wUrP4%2Fbanner%20-%202025-03-27T121508.169.png?alt=media&#x26;token=8b0e2474-c5fe-4ce9-99c2-e9f99a3751d0" alt=""><figcaption></figcaption></figure>

Project Setup

1. Clone the Repository:bash

   ```bash
   git clone https://github.com/Blockchain1Royale/OMNIFLUX-ALPHA.git
   cd OMNIFLUX-ALPHA
   ```
2. Install Dependencies:bash

   ```bash
   npm install
   ```
3. Set Up Environment Variables:bash

   ```bash
   cp .env.example .env
   nano .env  # Add your keys
   ```

Development Workflow

1. Start the Server:bash

   ```bash
   node server.js
   ```
2. Run the CLI:bash

   ```bash
   node packages/cli/interactive.cjs
   ```
3. Run Tests:bash

   ```bash
   npm test
   ```

Best Practices

* Modular Design: Follow the modular architecture for maintainability.
* Testing: Write tests for all new functionality.
* Documentation: Document APIs and provide usage examples.
* Error Handling: Implement robust error handling and validation.
* Logging: Use structured logging for debugging and monitoring.

***

Troubleshooting

* Server Fails to Start: Ensure port 8052 is free and dependencies are installed (npm install).
* Connection Errors: Verify the server is running (curl <http://localhost:8052/health>).
* Solana RPC Errors: Check your SOLANA\_RPC\_URL in .env and ensure it's valid.
* Python Wrapper Issues: Ensure the server is running and the package is installed correctly (pip install -e .).