Setup and installation#
In this guide, we will help you to get up and running with Argilla. Basically, you need to:
Install Argilla
Launch the web app
Start logging data
1. Install Argilla#
First, make sure you have Python 3.7 or above installed.
Then you can install Argilla with pip
or conda
.
with pip
pip install "argilla[server]==1.1.0"
with conda
conda install -c conda-forge "argilla-server==1.1.0"
2. Launch the web app#
Argilla uses Elasticsearch (ES) as its main persistent layer. If you do not have an ES instance running on your machine, we recommend setting one up via docker:
docker run -d --name elasticsearch-for-argilla -p 9200:9200 -p 9300:9300 -e "ES_JAVA_OPTS=-Xms512m -Xmx512m" -e "discovery.type=single-node" docker.elastic.co/elasticsearch/elasticsearch-oss:7.10.2
Note
For more details about setting up ES via docker, check our advanced setup guide.
You can start the Argilla web app via Python.
python -m argilla
Afterward, you should be able to access the web app at http://localhost:6900/.
The default username and password are argilla
and 1234
(see the user management guide to configure this).
Note
You can also launch the web app via docker or docker-compose. For the latter you do not need a running ES instance.
3. Start logging data#
The following code will log one record into a data set called example-dataset
:
import argilla as rg
rg.log(
rg.TextClassificationRecord(text="My first Argilla example"),
name='example-dataset'
)
If you now go to your Argilla app at http://localhost:6900/, you will find your first data set.