1Welcome to Stem!
2================
3
4Stem is a Python controller library for `Tor <https://www.torproject.org/>`_. With it you can use Tor's `control protocol <https://gitweb.torproject.org/torspec.git/tree/control-spec.txt>`_ to script against the Tor process, or build things such as `Nyx <https://nyx.torproject.org/>`_. Stem's latest version is **1.8** (released December 29th, 2019).
5
6.. Main Stem Logo
7   Source: http://www.wpclipart.com/plants/assorted/P/plant_stem.png.html
8   Author: Jakub Jankiewicz
9   License: Public Domain (http://www.wpclipart.com/legal.html#terms)
10
11   Alternate:
12   Source: http://andreajoseph24.blogspot.com/search/label/onions
13   Author: Andrea Joseph
14   License: CCv3 (NC, ND) - http://creativecommons.org/licenses/by-nc-nd/3.0/
15
16.. Source: NuoveXT 2 (http://nuovext.pwsp.net/)
17   Author: Alexandre Moore (http://sa-ki.deviantart.com/)
18   License: LGPL v3
19   File: NuoveXT 2.2/128x128/categories/applications-development.png
20
21.. image:: /_static/buttons/tutorials.png
22   :target: tutorials.html
23
24.. Source: http://www.cipherdyne.com/images/anvil.png
25   Author and license are unknown
26
27.. image:: /_static/buttons/api.png
28   :target: api.html
29
30.. Source: https://openclipart.org/detail/171951/help-by-diamonjohn-171951
31   Author: John Diamond (https://openclipart.org/user-detail/diamonjohn)
32   License: Public Domain
33
34   Alternate:
35   Source: Oxygen (http://www.oxygen-icons.org/)
36   Author: Andrea Joseph
37   License: CCv3 (A, SA) - http://creativecommons.org/licenses/by-sa/3.0/
38   File: Oxygen/128x128/categories/system-help.png
39
40.. image:: /_static/buttons/faq.png
41   :target: faq.html
42
43.. Source: Nuovo (http://www.silvestre.com.ar/?p=5)
44   Author: Silvestre Herrera (http://www.silvestre.com.ar/)
45   License: GPL v2
46   File: Nuovo/128x128/mimetypes/gnome-mime-text-log.png
47
48.. image:: /_static/buttons/change_log.png
49   :target: change_log.html
50
51.. Source: Crystal (http://www.everaldo.com/crystal/)
52   Author: Everaldo Coelho (http://www.everaldo.com/)
53   License: LGPL v2
54   File: Crystal/64x64/apps/bug.png
55
56.. image:: /_static/buttons/bug_tracker.png
57   :target: https://github.com/torproject/stem/issues/
58
59.. Source: ColorCons (http://mouserunner.com/Spheres_ColoCons1_Free_Icons.html)
60   Author: Ken Saunders (http://mouserunner.com/MRDS_Cell.html)
61   License: CC v2.5 (A, SA)
62   File: ColorCons/Blue/Download.png
63
64.. image:: /_static/buttons/download.png
65   :target: download.html
66
67.. toctree::
68   :maxdepth: 1
69
70