Metadata-Version: 2.4
Name: DashAI
Version: 0.1.4
Summary: DashAI: a graphical toolbox for training, evaluating and deploying state-of-the-art AI models.
Home-page: https://github.com/DashAISoftware/DashAI
Author: DashAI Team
Author-email: fbravo@dcc.uchile.cl
License: MIT
Project-URL: Documentation, https://dash-ai.com/
Project-URL: Changelog, https://dash-ai.com/changelog.html
Project-URL: Issue Tracker, https://github.com/DashAISoftware/DashAI/issues
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Requires-Dist: accelerate==1.0.1
Requires-Dist: aiohappyeyeballs==2.4.4
Requires-Dist: aiohttp==3.10.11
Requires-Dist: aiosignal==1.3.1
Requires-Dist: alembic==1.14.1
Requires-Dist: annotated-types==0.7.0
Requires-Dist: anyio==4.5.2
Requires-Dist: async-timeout==5.0.1
Requires-Dist: attrs==25.1.0
Requires-Dist: beartype==0.19.0
Requires-Dist: certifi==2025.1.31
Requires-Dist: charset-normalizer==3.4.1
Requires-Dist: click==8.1.8
Requires-Dist: cloudpickle==3.1.1
Requires-Dist: colorama==0.4.6
Requires-Dist: colorlog==6.9.0
Requires-Dist: contourpy==1.1.1
Requires-Dist: cycler==0.12.1
Requires-Dist: datasets==3.1.0
Requires-Dist: dill==0.3.8
Requires-Dist: dnspython==2.6.1
Requires-Dist: email-validator==2.2.0
Requires-Dist: et-xmlfile==2.0.0
Requires-Dist: evaluate==0.4.3
Requires-Dist: exceptiongroup==1.2.2
Requires-Dist: fastapi[all]==0.115.8
Requires-Dist: fastapi-cli[standard]==0.0.7
Requires-Dist: filelock==3.16.1
Requires-Dist: fonttools==4.56.0
Requires-Dist: frozenlist==1.5.0
Requires-Dist: fsspec[http]==2024.9.0
Requires-Dist: future==1.0.0
Requires-Dist: greenlet==3.1.1
Requires-Dist: h11==0.14.0
Requires-Dist: httpcore==1.0.7
Requires-Dist: httptools==0.6.4
Requires-Dist: httpx==0.28.1
Requires-Dist: huggingface-hub==0.29.1
Requires-Dist: hyperopt==0.2.7
Requires-Dist: idna==3.10
Requires-Dist: importlib-metadata==8.5.0
Requires-Dist: importlib-resources==6.4.5
Requires-Dist: itsdangerous==2.2.0
Requires-Dist: jinja2==3.1.5
Requires-Dist: joblib==1.4.2
Requires-Dist: kink==0.8.1
Requires-Dist: kiwisolver==1.4.7
Requires-Dist: llvmlite==0.41.1
Requires-Dist: lxml==5.3.1
Requires-Dist: mako==1.3.9
Requires-Dist: markdown-it-py==3.0.0
Requires-Dist: markupsafe==2.1.5
Requires-Dist: matplotlib==3.7.5
Requires-Dist: mdurl==0.1.2
Requires-Dist: mpmath==1.3.0
Requires-Dist: multidict==6.1.0
Requires-Dist: multiprocess==0.70.16
Requires-Dist: narwhals==1.27.1
Requires-Dist: networkx==3.1
Requires-Dist: numba==0.58.1
Requires-Dist: numpy==1.24.4
Requires-Dist: openpyxl==3.1.5
Requires-Dist: optuna==4.2.1
Requires-Dist: orjson==3.10.15
Requires-Dist: packaging==24.2
Requires-Dist: pandas==2.0.3
Requires-Dist: pillow==10.4.0
Requires-Dist: plotly==6.0.0
Requires-Dist: portalocker==3.0.0
Requires-Dist: propcache==0.2.0
Requires-Dist: psutil==7.0.0
Requires-Dist: py4j==0.10.9.9
Requires-Dist: pyarrow==17.0.0
Requires-Dist: pydantic==2.10.6
Requires-Dist: pydantic-core==2.27.2
Requires-Dist: pydantic-extra-types==2.10.2
Requires-Dist: pydantic-settings==2.8.0
Requires-Dist: pygments==2.19.1
Requires-Dist: pyparsing==3.1.4
Requires-Dist: python-dateutil==2.9.0.post0
Requires-Dist: python-dotenv==1.0.1
Requires-Dist: python-multipart==0.0.20
Requires-Dist: pytz==2025.1
Requires-Dist: pyyaml==6.0.2
Requires-Dist: regex==2024.11.6
Requires-Dist: requests==2.32.3
Requires-Dist: rich==13.9.4
Requires-Dist: rich-toolkit==0.13.2
Requires-Dist: sacrebleu==2.5.1
Requires-Dist: safetensors==0.5.2
Requires-Dist: scikit-learn==1.3.2
Requires-Dist: scipy==1.10.1
Requires-Dist: sentencepiece==0.2.0
Requires-Dist: shap==0.44.1
Requires-Dist: shellingham==1.5.4
Requires-Dist: six==1.17.0
Requires-Dist: slicer==0.0.7
Requires-Dist: smart-open==7.1.0
Requires-Dist: sniffio==1.3.1
Requires-Dist: sqlalchemy==2.0.38
Requires-Dist: starlette==0.44.0
Requires-Dist: streaming-form-data==1.16.0
Requires-Dist: sympy==1.13.3
Requires-Dist: tabulate==0.9.0
Requires-Dist: threadpoolctl==3.5.0
Requires-Dist: tokenizers==0.20.3
Requires-Dist: torch==2.4.1
Requires-Dist: tqdm==4.67.1
Requires-Dist: transformers==4.46.3
Requires-Dist: typer==0.15.1
Requires-Dist: typing-extensions==4.12.2
Requires-Dist: tzdata==2025.1
Requires-Dist: ujson==5.10.0
Requires-Dist: urllib3==2.2.3
Requires-Dist: uvicorn[standard]==0.33.0
Requires-Dist: watchfiles==0.24.0
Requires-Dist: websockets==13.1
Requires-Dist: wordcloud==1.9.4
Requires-Dist: wrapt==1.17.2
Requires-Dist: xxhash==3.5.0
Requires-Dist: yarl==1.15.2
Requires-Dist: zipp==3.20.2
Requires-Dist: imblearn
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: license
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

============
DashAI
============

.. image:: https://img.shields.io/pypi/v/dashai.svg
        :target: https://pypi.python.org/pypi/dashai

.. image:: https://readthedocs.org/projects/dashai/badge/?version=latest
        :target: https://dashai.readthedocs.io/en/latest/?version=latest
        :alt: Documentation Status


A graphical toolbox for training, evaluating and deploying state-of-the-art
AI models

.. image:: ./images/DashAI_banner.png
   :alt: DashAI Logo

Quick installation (Pypi)
=========================


DashAI needs Python 3.8 or greater to be installed. Once that requirement is satisfied, you can install DashAI via pip:

.. code:: bash

    $ pip install dashai

Then, to initialize the server and the graphical interface, run:

.. code:: bash

    $ dashai

Finally, go to `http://localhost:3000/ <http://localhost:3000/>`_ in your browser to access to the DashAI graphical interface.


Test datasets
=============

Some datasets you can use to try DashAI are available `here <https://github.com/DashAISoftware/DashAI_Datasets>`_.


Development
===========


To download and run the development version of DashAI, first, download the repository
and switch to the developing branch: :

.. code:: bash

    $ git clone https://github.com/DashAISoftware/DashAI.git
    $ git checkout develop


Frontend
--------

.. warning::

    All commands executed in this section must be run
    from `DashAI/front`. To move there, run:

    .. code::

        $ cd DashAI/front


Prepare the environment
~~~~~~~~~~~~~~~~~~~~~~~

1. `Install the LTS node version <https://nodejs.org/en>`_.

2. Install `Yarn` package manager following the instructions located on the
   `yarn getting started <https://yarnpkg.com/getting-started>`_ page.

3. Move to `DashAI/front` and Install the project packages
   using yarn:

.. code:: bash

    $ cd DashAI/front
    $ yarn install


Running the frontend
~~~~~~~~~~~~~~~~~~~~~~

Move to DashAI/front if you are not on that route:

.. code:: bash

    $ cd DashAI/front

Then, launch the front-end development server by running the following command:

.. code:: bash

    $ yarn start

If you want to launch the front-end test server (without launching the backend) with dummy data, run:

.. code:: bash

    $ yarn json-server

Linting and formatting
~~~~~~~~~~~~~~~~~~~~~~

The project uses as default linter `eslint <https://eslint.org/>`_ with
the `react/recommended`, `standard-with-typescript`` and `prettier`` styles.

To manually run the linter, move to `DashAI/front` and run:

.. code:: bash

    $ yarn eslint src


The project uses `prettier <https://prettier.io/>`_ as default formatter.

To format the code manually, move to `DashAI/front` and execute:

.. code:: bash

    $ yarn prettier --write src


Build the frontend
~~~~~~~~~~~~~~~~~~

Execute from `DashAI/front`:

.. code:: bash

    $ yarn build

Backend
-------


Prepare the environment
~~~~~~~~~~~~~~~~~~~~~~~

First, set the python enviroment using
`conda <https://docs.conda.io/en/latest/miniconda.html>`_:

.. code: bash

    $ conda create -n dashai python=3.10
    $ conda activate dashai

Then, move to `DashAI/back`

.. code:: bash

    $ cd DashAI/back


Later, install the requirements:

.. code:: bash

    $ pip install -r requirements.txt
    $ pip install -r requirements-dev.txt


Running the Backend
~~~~~~~~~~~~~~~~~~~

There are three ways to run DashAI:

1. By executing DashAI as a module:

.. code:: bash

    $ python -m DashAI

2. Or,  installing the default build:

.. code:: bash

    $ pip install .
    $ dashai

If you chose the second way, remember to install it each time you make changes.

**Setting the local execution path**

With the `--local-path` option you can determine where DashAI will save its local
files, such as datasets, experiments, runs and others.
The following example shows how to set the folder in the local `.DashAI` directory:

.. code:: bash

    $ python -m DashAI --local-path "~/.DashAI"


**Setting the logging level**

Through the --logging_level parameter, you can set which logging level the DashAI
backend server will have.

.. code:: bash

    $ python -m DashAI --logging-level INFO

The possible levels available are: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`.

Note that the --logging-level not only affects the DashAI loggers, but also
the datasets (which is set to the same level as DashAI) and the
SQLAlchemy (which is only activated when logging level is DEBUG).


**Checking Available Options**

You can check all available options through the command:

.. code:: bash

    $ python -m DashAI --help

Execute tests
~~~~~~~~~~~~~

DashAI uses `pytest <https://docs.pytest.org/>`_ to perform the backend
tests.
To execute the backend tests

1. Move to `DashAI/back`

.. code:: bash

    $ cd DashAI/back

2. Run:

.. code:: bash

    $ pytest tests/

.. note::

    The database session is parametrized in every endpoint as
    ``db: Session = Depends(get_db)`` so we can test endpoints on a test database
    without making changes to the main database.


Linting and formatting
~~~~~~~~~~~~~~~~~~~~~~

The project uses as default backend linter
`ruff <https://github.com/charliermarsh/ruff>`_:

To manually run the linter, move to `DashAI/back` and execute:

.. code:: bash

    $ ruff .


The project uses `black <https://black.readthedocs.io/en/stable/>`_ as default formatter.

To manually format the code, move to `DashAI/back` and execute:

.. code:: bash

    $ black .


Acknowledgments
===============

This project is sponsored by the `National Center for Artificial Intelligence - CENIA <https://cenia.cl/en/>`_ (FB210017), and the `Millennium Institute for Foundational Data Research - IMFD <https://imfd.cl/en/>`_ (ICN17_002).

The core of the development is carried out by students from the Computer Science Department of the University of Chile and the Federico Santa Maria Technical University.

To see the full list of contributors, visit in `Contributors <https://github.com/DashAISoftware/DashAI/graphs/contributors>`_ the DashAI repository on Github.

.. image:: ./images/logos.png
   :alt: Collaboration Logos
