TensorFlow Agents

Apprendimento per rinforzo con TensorFlow

Gli agenti semplificano la progettazione, l'implementazione e il test di nuovi algoritmi RL, fornendo componenti modulari ben testati che possono essere modificati ed estesi. Consente una rapida iterazione del codice, con una buona integrazione dei test e benchmarking.

Per iniziare, ti consigliamo di dare un'occhiata a uno dei nostri tutorial .

Installazione

TF-Agents pubblica build notturne e stabili. Per un elenco delle versioni leggere la sezione Versioni . I comandi seguenti riguardano l'installazione di TF-Agent stabile e notturna da pypi.org e da un clone di GitHub.

Stabile

Esegui i comandi seguenti per installare la versione stabile più recente. La documentazione API per il rilascio è su tensorflow.org .

$ pip install --user tf-agents[reverb]

# Use this tag get the matching examples and colabs.
$ git clone https://github.com/tensorflow/agents.git
$ cd agents
$ git checkout v0.7.1

Se desideri installare TF-Agent con versioni di Tensorflow o Reverb contrassegnate come non compatibili dal controllo delle dipendenze pip, utilizza il seguente schema a tuo rischio.

$ pip install --user tensorflow
$ pip install --user dm-reverb
$ pip install --user tf-agents

Se desideri utilizzare TF-Agent con TensorFlow 1.15 o 2.0, installa la versione 0.3.0:

# Newer versions of tensorflow-probability require newer versions of TensorFlow.
$ pip install tensorflow-probability==0.8.0
$ pip install tf-agents==0.3.0

Ogni notte

Le build notturne includono funzionalità più recenti, ma potrebbero essere meno stabili rispetto alle versioni con versione. La build nightly viene inviata come tf-agents-nightly . Suggeriamo di installare le versioni notturne di TensorFlow ( tf-nightly ) e TensorFlow Probability ( tfp-nightly ) in quanto sono le versioni contro cui TF-Agents nightly viene testato.

Per installare la versione build notturna, eseguire quanto segue:

# `--force-reinstall helps guarantee the right versions.
$ pip install --user --force-reinstall tf-nightly
$ pip install --user --force-reinstall tfp-nightly
$ pip install --user --force-reinstall dm-reverb-nightly

# Installing with the `--upgrade` flag ensures you'll get the latest version.
$ pip install --user --upgrade tf-agents-nightly

Da GitHub

Dopo la clonazione del repository, le dipendenze possono essere installate eseguendo pip install -e .[tests] . TensorFlow deve essere installato in modo indipendente: pip install --user tf-nightly .

Contribuire

Siamo ansiosi di collaborare con te! Vedi CONTRIBUTING.md per una guida su come contribuire. Questo progetto aderisce al codice di condotta di TensorFlow. Partecipando, ci si aspetta che tu mantenga questo codice.

Rilasci

TF Agents ha versioni stabili e notturne. Le versioni notturne spesso vanno bene, ma possono avere problemi a causa del flusso di librerie a monte. La tabella seguente elenca le versioni di TensorFlow testate con ciascuna versione di TF Agent per aiutare gli utenti che potrebbero essere bloccati in una versione specifica di TensorFlow.

I principi

Questo progetto aderisce ai principi dell'IA di Google . Partecipando, utilizzando o contribuendo a questo progetto ci si aspetta che aderisca a questi principi.

Citazione

Se utilizzi questo codice, citalo come:

@misc{TFAgents,
  title = { {TF-Agents}: A library for Reinforcement Learning in TensorFlow},
  author = {Sergio Guadarrama and Anoop Korattikara and Oscar Ramirez and
     Pablo Castro and Ethan Holly and Sam Fishman and Ke Wang and
     Ekaterina Gonina and Neal Wu and Efi Kokiopoulou and Luciano Sbaiz and
     Jamie Smith and Gábor Bartók and Jesse Berent and Chris Harris and
     Vincent Vanhoucke and Eugene Brevdo},
  howpublished = {\url{https://github.com/tensorflow/agents} },
  url = "https://github.com/tensorflow/agents",
  year = 2018,
  note = "[Online; accessed 25-June-2019]"
}