Skip to content

Repository files navigation

https://img.shields.io/badge/version-1.3.1-blue https://img.shields.io/github/license/odevio/odevio-cli https://img.shields.io/librariesio/release/pypi/odevio https://img.shields.io/pypi/dm/odevio UptimeRobot CodeFactor

Build and publish iOS apps with your AI agent - no Mac, no iOS jargon

Odevio lets an AI agent build and publish your iOS apps for you. It runs the build and signing on remote Macs, so you need no Mac, no Xcode and no iOS knowledge. Claude Code is the first AI agent supported. Thanks for checking it out.

Installation

Odevio is a CLI utility developed in Python. It is easily installed with pip.

pip install odevio

Use it with an AI agent

The way to use Odevio is to let your AI agent drive it. Install the skill once (this sets up Claude Code, the first AI agent supported):

odevio skill install

Then, in your Flutter project, just ask your agent to put your app on your iPhone. It writes the code, Odevio builds and signs it on a real Mac, fixes what breaks, and ships it to TestFlight. See the AI agent guide.

Use the CLI yourself

Prefer to drive Odevio directly? To start using Odevio simply run odevio in your console.

Start by creating an account

odevio signup

Your Odevio account is now created and you can either start a build machine in configuration mode : to configure XCode or test your app in the iOS simulator.

odevio build start --build-type configuration

Or you can build an IPA or release your app by linking your Apple Developer Account to Odevio and creating an app identifier

odevio apple add --apple-id APPLE_TEAM_ID --name TEXT --key-id APPLE_KEY_ID --issuer-id APPLE_ISSUER_ID --private-key LOCATION_APPLE_PRIVATE_KEY
odevio app mk --name MY_APP_NAME --bundle-id COM.COMPANY.APP_NAME

To create the IPA to install on a physical device for testing purposes

odevio build start --build-type ad-hoc
odevio build ipa

To publish directly to the App Store

odevio build start --build-type publication

Your build failed ? No worries, you can check the logs with

odevio build logs

Documentation

All documentation is in the docs directory and online at https://odevio-cli.readthedocs.io/. If you are getting started this is how we recommend you use the docs :

About

Our mission is to let anyone build and publish an iOS app through an AI agent, without owning a Mac or knowing the iOS ecosystem.

Odevio gives your AI agent the tools to build and ship iOS apps for you.

What does Odevio do for you ?

  1. It lets an AI agent such as Claude Code drive the whole flow from plain-language requests.
  2. It manages iOS specifics - certificates, devices, provisioning profiles, bundle IDs, Xcode configuration.
  3. It builds your Flutter app on remote Macs, so you need no Mac of your own.
  4. It fixes build failures, then hosts the app or ships it to TestFlight and the App Store.

Contributing

Thank you for considering contributing to Odevio. The main purpose of this repository is to continue evolving Odevio to make Flutter developer's lives easier.

Please report improvements, bugs and issues to Github's issue tracker. Pull requests linked to open issues are even more appreciated.

Odevio's GitHub issue tracker is not intended to provide help or support. For that, see the documentation.

We are also thrilled to receive a variety of other contributions including:

  • Documentation updates, enhancements, designs, or bugfixes.
  • Spelling or grammar fixes.
  • Blogging, speaking about, or creating tutorials about Odevio.

Giving Odevio a Github star is much appreciated by our team ! Sharing our project with other Flutter developers is too :)

About

Odevio, the easy way to setup, build & release flutter apps for iOS on Linux, Windows and MacOS

Topics

Resources

Stars

421 stars

Watchers

8 watching

Forks

Releases

Packages

Used by

Contributors

Languages