🔆 Highlights
User roles & settings page
We've introduced two user roles to help you manage your annotation team: `admin` and `annotator`. `admin` users can create, list and delete other users, workspaces and datasets. The `annotator` role is specifically designed for users who focus solely on annotating datasets.
<img width="1507" alt="User settings page" src="https://user-images.githubusercontent.com/126158523/230874953-402034f0-d170-4f6a-9e6a-4a0fea9754a1.png">
We've also added a page to see your user's settings in the Argilla UI. To access it click on your user avatar at the top right corner and then select `My settings`.
Argilla Trainer
The new `Argilla.training` module deals with all data transformations and basic default configurations to train a model with annotations from Argilla using popular NLP frameworks. It currently supports `spacy`, `setfit` and `transformers`.
Additionally, `admin` users can access ready-made code snippets to copy-paste directly from the Argilla UI. Just go to the dataset you want to use, click the `</> Train` button in the top banner and select your preferred framework.
<img width="1506" alt="Ready-made code snippet to train a model using the `alpaca-clean-en` dataset and `setfit` as shown in the Argilla UI" src="https://user-images.githubusercontent.com/126158523/230872180-9a71159e-7dbc-46cd-8043-73325971f4eb.png">
Learn more about `Argilla.training` [in our docs](https://docs.argilla.io/en/latest/guides/train_a_model.html).
Database support
Argilla will now create a default SQLite database to store users and workspaces. PostgreSQL is also officially supported. Simply set a custom value for the `ARGILLA_DATABASE_URL` environment variable pointing to your PostgreSQL instance.
[Changelog 1.6.0](https://github.com/argilla-io/argilla/compare/v1.5.1...v1.6.0)
Added
- `ARGILLA_HOME_PATH` new environment variable ([2564]).
- `ARGILLA_DATABASE_URL` new environment variable ([2564]).
- Basic support for user roles with `admin` and `annotator` ([2564]).
- `id`, `first_name`, `last_name`, `role`, `inserted_at` and `updated_at` new user fields ([2564]).
- `/api/users` new endpoint to list and create users ([2564]).
- `/api/users/{user_id}` new endpoint to delete users ([2564]).
- `/api/workspaces` new endpoint to list and create workspaces ([2564]).
- `/api/workspaces/{workspace_id}/users` new endpoint to list workspace users ([2564]).
- `/api/workspaces/{workspace_id}/users/{user_id}` new endpoint to create and delete workspace users ([2564]).
- `argilla.tasks.users.migrate` new task to migrate users from old YAML file to database ([2564]).
- `argilla.tasks.users.create` new task to create a user ([2564]).
- `argilla.tasks.users.create_default` new task to create a user with default credentials ([2564]).
- `argilla.tasks.database.migrate` new task to execute database migrations ([2564]).
- `release.Dockerfile` and `quickstart.Dockerfile` now creates a default `argilladata` volume to persist data ([2564]).
- Add user settings page. Closes [2496](https://github.com/argilla-io/argilla/issues/2496)
- Added `Argilla.training` module with support for `spacy`, `setfit`, and `transformers`. Closes [2504](https://github.com/argilla-io/argilla/issues/2496)
Fixes
- Now the `prepare_for_training` method is working when `multi_label=True`. Closes [2606](https://github.com/argilla-io/argilla/issues/2606)
Changed
- `ARGILLA_USERS_DB_FILE` environment variable now it's only used to migrate users from YAML file to database ([2564]).
- `full_name` user field is now deprecated and `first_name` and `last_name` should be used instead ([2564]).
- `password` user field now requires a minimum of `8` and a maximum of `100` characters in size ([2564]).
- `quickstart.Dockerfile` image default users from `team` and `argilla` to `admin` and `annotator` including new passwords and API keys ([2564]).
- Datasets to be managed only by users with `admin` role ([2564]).
- The list of rules is now accessible while metrics are computed. Closes[2117](https://github.com/argilla-io/argilla/issues/2117)
- Style updates for weak labelling and adding feedback toast when delete rules. See [2626](https://github.com/argilla-io/argilla/pull/2626) and [#2648](https://github.com/argilla-io/argilla/pull/2648)
Removed
- `email` user field ([2564]).
- `disabled` user field ([2564]).
- Support for private workspaces ([2564]).
- `ARGILLA_LOCAL_AUTH_DEFAULT_APIKEY` and `ARGILLA_LOCAL_AUTH_DEFAULT_PASSWORD` environment variables. Use `python -m argilla.tasks.users.create_default` instead ([2564]).
- The old headers for `API Key` and `workspace` from python client
- The default value for old `API Key` constant. Closes [2251](https://github.com/argilla-io/argilla/issues/2251)
[2564]: https://github.com/argilla-io/argilla/issues/2564
As always, thanks to our amazing contributors!
- feat: add ArgillaSpaCyTrainer for both TokenClassification and TextClassification (2604) by alvarobartt
- Move dataset dump to train, ignored unnecessary imports, & remove _required_fields attribute (2642) by alvarobartt
- fix: update field name in metadata for image url (2609) by burtenshaw
- fix Install doc spell error by PhilipMay
- fix: broken README.md link (2616) by alvarobartt