{"id":15672731,"url":"https://github.com/sollimann/airsim-client","last_synced_at":"2025-10-26T02:49:48.415Z","repository":{"id":65416144,"uuid":"523867703","full_name":"Sollimann/airsim-client","owner":"Sollimann","description":"A Rust client library for Airsim.","archived":false,"fork":false,"pushed_at":"2023-09-18T11:50:23.000Z","size":702,"stargazers_count":18,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-16T16:50:36.818Z","etag":null,"topics":["airsim","airsim-simulator","autonomy","drone","robotics","rust-lang","rust-library","unreal"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sollimann.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-08-11T21:01:21.000Z","updated_at":"2025-03-03T19:19:34.000Z","dependencies_parsed_at":"2024-10-23T10:58:15.298Z","dependency_job_id":"cf90bfbc-b581-4308-b91a-071250832bfa","html_url":"https://github.com/Sollimann/airsim-client","commit_stats":{"total_commits":76,"total_committers":2,"mean_commits":38.0,"dds":"0.052631578947368474","last_synced_commit":"6ab750f2b08ed03ad7e5c2204153284194b017a3"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sollimann%2Fairsim-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sollimann%2Fairsim-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sollimann%2Fairsim-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sollimann%2Fairsim-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sollimann","download_url":"https://codeload.github.com/Sollimann/airsim-client/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249675582,"owners_count":21309326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["airsim","airsim-simulator","autonomy","drone","robotics","rust-lang","rust-library","unreal"],"created_at":"2024-10-03T15:30:47.043Z","updated_at":"2025-10-26T02:49:43.373Z","avatar_url":"https://github.com/Sollimann.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\" font-size:4em;\"\u003e Rust Airsim \u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/Sollimann/airsim-client/blob/main/docs/drone_lobby.png\" width=\"750\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cem\u003e A Rust Client library for Microsoft Airsim\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cem\u003e Contributions are welcome! \u003c/em\u003e\n\u003c/p\u003e\n\n[![Build Status](https://github.com/Sollimann/airsim-client/actions/workflows/rust-ci.yml/badge.svg?event=push)](https://github.com/Sollimann/airsim-client/actions)\n[![airsim-client crate](https://img.shields.io/crates/v/airsim-client.svg)](https://crates.io/crates/airsim-client)\n[![minimum rustc 1.56](https://img.shields.io/badge/rustc-1.56+-blue.svg)](https://rust-lang.github.io/rfcs/2495-min-rust-version.html)\n[![Docs](https://docs.rs/airsim-client/badge.svg)](https://docs.rs/airsim-client)\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://GitHub.com/Sollimann/airsim-client/graphs/commit-activity)\n[![GitHub pull-requests](https://img.shields.io/github/issues-pr/Sollimann/airsim-client.svg)](https://GitHub.com/Sollimann/airsim-client/pulls)\n[![GitHub pull-requests closed](https://img.shields.io/github/issues-pr-closed/Sollimann/airsim-client.svg)](https://GitHub.com/Sollimann/airsim-client/pulls)\n![ViewCount](https://views.whatilearened.today/views/github/Sollimann/airsim-client.svg)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## How to use\n\nSee [examples](examples/) folder for more!\n\nUse e.g this [settings.json](examples/multirotor/settings.json) to configure multirotor in Airsim\n\nOnce you have Airsim up and running (some examples below on how run), execute the snippet:\n\n```rust\nuse airsim_client::{DrivetrainType, MultiRotorClient, NetworkResult, Path, Vector3, YawMode};\nuse async_std::task;\n\nasync fn connect_drone() -\u003e NetworkResult\u003c()\u003e {\n    let address = \"\u003cAirsim IP here\u003e:41451\"; // set with env variable\n    let vehicle_name = \"\"; // use default vehicle name\n    log::info!(\"Start!\");\n\n    // connect\n    log::info!(\"connect\");\n    let client = MultiRotorClient::connect(address, vehicle_name).await?;\n\n    // confirm connect\n    log::info!(\"confirm connection\");\n    let res = client.confirm_connection().await?;\n    log::info!(\"Response: {:?}\", res);\n\n    // arm drone\n    log::info!(\"arm drone\");\n    client.arm_disarm(true).await?;\n    log::info!(\"Response: {:?}\", res);\n\n    // take off\n    log::info!(\"take off drone\");\n    client.take_off_async(20.0).await?;\n    log::info!(\"take off completed\");\n\n    log::info!(\"move on path\");\n    client\n        .move_on_path_async(\n            Path(vec![\n                Vector3::new(-25.0, 0.0, -20.0),\n                Vector3::new(-50.0, 50.0, -20.0),\n                Vector3::new(-50.0, -50.0, -25.0),\n            ]),\n            5.0,\n            1000.0,\n            DrivetrainType::MaxDegreeOfFreedom,\n            YawMode::new(false, 90.0),\n            None,\n            None,\n        )\n        .await?;\n    log::info!(\"done!\");\n\n    log::info!(\"go home\");\n    client.go_home_async(20.0).await?;\n    log::info!(\"got home\");\n\n    log::info!(\"land drone\");\n    let landed = client.land_async(20.0).await?;\n    log::info!(\"drone landed: {landed}\");\n\n    log::info(\"Disarm drone\")\n    client.arm_disarm(false).await?;\n    client.enable_api_control(false).await?;\n    Ok(())\n}\n\nfn main() -\u003e NetworkResult\u003c()\u003e {\n    env_logger::init();\n    task::block_on(connect_drone())\n}\n```\n\n## Pre-requisites to build project\n\n```sh\n$ sudo apt install build-ess    ential\n```\n\n## Running with Docker\n\nInstall `docker-nvidia` first\n\nthen\n\n```sh\n$ make airsim-up\n```\n\n## WSL2 (client) and Windows 11 Server\n\nhttps://docs.microsoft.com/en-us/windows/wsl/networking\n\nOpen Windows PowerShell in directory `Blocks\\Blocks\\WindowsNoEditor` and type:\n\n```PowerShell\n./Blocks.exe -ResX=640 -ResY=480 -windowed\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsollimann%2Fairsim-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsollimann%2Fairsim-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsollimann%2Fairsim-client/lists"}