🌞 What is sunnypilot?

sunnypilot is a fork of comma.ai's openpilot, an open source driver assistance system. sunnypilot offers the user a unique driving experience for over 300+ supported car makes and models with modified behaviors of driving assist engagements. sunnypilot complies with comma.ai's safety rules as accurately as possible.

💭 Join our Community Forum

Join the official sunnypilot community forum to stay up to date with all the latest features and be a part of shaping the future of sunnypilot!

• https://community.sunnypilot.ai/

Documentation

https://docs.sunnypilot.ai/ is your one stop shop for everything from features to installation to FAQ about the sunnypilot

🚘 Running on a dedicated device in a car

• A supported device to run this software
  • a comma three or a C3X
• This software
• One of the 325+ supported cars. We support Honda, Toyota, Hyundai, Nissan, Kia, Chrysler, Lexus, Acura, Audi, VW, Ford, and more. If your car is not supported but has adaptive cruise control and lane-keeping assist, it's likely able to run sunnypilot.
• A car harness to connect to your car

Detailed instructions for how to mount the device in a car.

Installation

Please refer to Recommended Branches to find your preferred/supported branch. This guide will assume you want to install the latest staging branch.

If you want to use our newest branches (our rewrite)

Tip

You can see the rewrite state on our rewrite project board, and to install the new branches, you can use the following links

• sunnypilot not installed or you installed a version before 0.8.17?

  1. Factory reset/uninstall the previous software if you have another software/fork installed.
  2. After factory reset/uninstall and upon reboot, select Custom Software when given the option.
  3. Input the installation URL per Recommended Branches. Example: https://staging.sunnypilot.ai.
  4. Complete the rest of the installation following the onscreen instructions.

• sunnypilot already installed and you installed a version after 0.8.17?

  1. On the comma three/3X, go to Settings ▶️ Software.
  2. At the Download option, press CHECK. This will fetch the list of latest branches from sunnypilot.
  3. At the Target Branch option, press SELECT to open the Target Branch selector.
  4. Scroll to select the desired branch per Recommended Branches (see below). Example: staging

Recommended Branches

Branch	Installation URL
release	https://release.sunnypilot.ai
staging	https://staging.sunnypilot.ai
dev	https://dev.sunnypilot.ai
custom-branch	https://install.sunnypilot.ai/{branch_name}

Tip

You can use sunnypilot/targetbranch as an install URL. Example: 'sunnypilot/staging'.

Note

Do you require further assistance with software installation? Join the sunnypilot community forum and create a topic in the General/Q&A Category channel.

Older legacy branches

If you want to use our older legacy branches (not recommended)

[IMPORTANT] It is recommended to re-flash AGNOS if you intend to downgrade from the new branches. You can still restore the latest sunnylink backup made on the old branches.

Branch	Installation URL
release-c3	https://release-c3.sunnypilot.ai
staging-c3	https://staging-c3.sunnypilot.ai
dev-c3	https://dev-c3.sunnypilot.ai

🎆 Pull Requests

We welcome both pull requests and issues on GitHub. Bug fixes are encouraged.

Pull requests should be against the most current master branch.

📊 User Data

By default, sunnypilot uploads the driving data to comma servers. You can also access your data through comma connect.

sunnypilot is open source software. The user is free to disable data collection if they wish to do so.

sunnypilot logs the road-facing camera, CAN, GPS, IMU, magnetometer, thermal sensors, crashes, and operating system logs. The driver-facing camera and microphone are only logged if you explicitly opt-in in settings.

By using this software, you understand that use of this software or its related services will generate certain types of user data, which may be logged and stored at the sole discretion of comma. By accepting this agreement, you grant an irrevocable, perpetual, worldwide right to comma for the use of this data.

Licensing

sunnypilot is released under the MIT License. This repository includes original work as well as significant portions of code derived from openpilot by comma.ai, which is also released under the MIT license with additional disclaimers.

The original openpilot license notice, including comma.ai’s indemnification and alpha software disclaimer, is reproduced below as required:

openpilot is released under the MIT license. Some parts of the software are released under other licenses as specified.

Any user of this software shall indemnify and hold harmless Comma.ai, Inc. and its directors, officers, employees, agents, stockholders, affiliates, subcontractors and customers from and against all allegations, claims, actions, suits, demands, damages, liabilities, obligations, losses, settlements, judgments, costs and expenses (including without limitation attorneys’ fees and costs) which arise out of, relate to or result from any use of this software by user.

THIS IS ALPHA QUALITY SOFTWARE FOR RESEARCH PURPOSES ONLY. THIS IS NOT A PRODUCT. YOU ARE RESPONSIBLE FOR COMPLYING WITH LOCAL LAWS AND REGULATIONS. NO WARRANTY EXPRESSED OR IMPLIED.

For full license terms, please see the LICENSE file.

💰 Support sunnypilot

If you find any of the features useful, consider becoming a sponsor on GitHub to support future feature development and improvements.

By becoming a sponsor, you will gain access to exclusive content, early access to new features, and the opportunity to directly influence the project's development.

GitHub Sponsor

PayPal

Your continuous love and support are greatly appreciated! Enjoy 🥰

- Jason, Founder of sunnypilot