.. _installation:
    
============
Installation
============

There are four ways to use Odevio. Pick the one that fits how you work — they all drive the same build
machines, and you can mix them freely.

.. list-table::
    :widths: 25 75
    :header-rows: 1

    * - Way in
      - Best for
    * - :doc:`AI assistant <../ai_assistant/index>`
      - Describing what you want in plain words and letting an assistant such as Claude Code do the rest,
        including fixing build errors on its own. **Start here if you are new to iOS.**
    * - Desktop client
      - Clicking through builds in a window, with nothing to learn. Covered below.
    * - :doc:`Command line <../installation_cli/index>`
      - Scripting, and everything the desktop client does not expose.
    * - :doc:`CI/CD <../cicd/index>`
      - Building automatically from your pipeline on every push.

The AI assistant route is the newest, and the shortest for a first iOS build: it installs in one command on
top of the command line, and it walks you through the Apple side rather than leaving you to work it out.

----

The desktop client
==================

Install it by downloading and running Odevio's client.

For |windows_cient|.

For |linux_cient|.

For |mac_cient|.

Once installed, you can easily run the client from your desktop.

If it is your first time using Odevio, you are required to create an account. 

.. image:: /img/desktop-signup.jpg
  :alt: Odevio sign up
  :align: center

|

Otherwise, you can log in using your existing credentials.

.. image:: /img/desktop-login.jpg
  :alt: Odevio login
  :align: center

|

Once logged in, you will see this welcome screen.

.. image:: /img/odevio-welcome.jpg
  :alt: Odevio Welcome Screen
  :align: center

|

.. |windows_cient| raw:: html

   <a href="https://odevio.com/odevio-desktop/odevio-desktop-windows/" target="_blank">Windows</a>

.. |linux_cient| raw:: html

   <a href="https://odevio.com/odevio-desktop/odevio-desktop-linux/" target="_blank">Linux</a>

.. |mac_cient| raw:: html

   <a href="https://odevio.com/odevio-desktop/odevio-desktop-macos/" target="_blank">Mac</a>
   