Behold-Urwar-Droid-Concepts

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

Behold-Urwar-Droid-Concepts

★ 13 Open GitHub ↗

An all-in one place for information and creation of BD class droids from Behold-Urwar Droid Concepts

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Behold-Urwar-Droid-Concepts

A modern web interface for training and testing duck droid models using reinforcement learning, built with Flask and UV.

## Architecture

```mermaid
graph TD
    A[Web Interface] --> B[Flask Application]
    B --> C[Routes]
    B --> D[Services]
    B --> E[Utils]
    
    C --> F[Training Routes]
    C --> G[Testing Routes]
    C --> H[Model Routes]
    
    D --> I[Training Service]
    D --> J[Model Service]
    D --> K[Playground Service]
    
    E --> L[Config Utils]
    E --> M[Model Utils]
    E --> N[Visualization Utils]
    
    I --> O[Open Duck Playground]
    J --> P[ONNX Runtime]
    K --> Q[Reference Motion Generator]
```

## Features

- Generate reference motions using Placo
- Train policies using imitation learning
- Test trained models in a playground environment
- Export models to ONNX format
- Visualize results in 3D

## Prerequisites

- Python 3.11 or higher
- Git
- CUDA-capable GPU (recommended for training)
- UV package manager

## Installation

### 1. Install UV

First, install UV (a fast Python package installer and resolver):

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

### 2. Clone and Setup

```bash
# Clone the repository

git clone https://github.com/Aronnaxx/Behold-Urwar-Droid-Concepts.git
cd Behold-Urwar-Droid-Concepts

# Initialize and update submodules
git submodule update --init --recursive
```

## Running the Application

1. Start the web interface:
```bash
uv python pin 3.11
uv run app.py
```

2. Open your browser and navigate to:
```
http://localhost:5002
```

## Project Structure

```
.
├── app/                    # Core application code
│   ├── config/           # Configuration files
│   ├── routes/           # Flask routes
│   ├── services/         # Business logic
│   ├── static/          # Static assets
│   ├── templates/       # HTML templates
│   └── utils/           # Utility functions
├── submodules/          # Git submodules
│   ├── open_duck_mini/  # Duck model definitions
│   ├── open_duck_playground/  # Training environment
│   └── open_duck_reference_motion_generator/  # Motion generation
├── output/              # Generated outputs
├── .env                # Environment configuration
├── app.py             # Main Flask application
├── pyproject.toml     # Python package configuration
└── uv.lock           # UV dependency lock file
```

## Development

### Code Style

This project uses:
- Black for code formatting
- isort for import sorting
- flake8 for linting

Run the formatters:
```bash
black .
isort .
```

### Running Tests

```bash
pytest
```

## License

MIT License - see LICENSE file for details

Behold-Urwar-Droid-Concepts

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README