# Interact.jl

**Repository Path**: Julialang/Interact.jl

## Basic Information

- **Project Name**: Interact.jl
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-03-12
- **Last Updated**: 2024-12-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Interact

[![Build Status](https://travis-ci.org/JuliaGizmos/Interact.jl.svg?branch=master)](https://travis-ci.org/JuliaGizmos/Interact.jl)

Interact.jl allows you to use interactive widgets such as sliders, dropdowns and checkboxes to play with your Julia code.

![Screenshot](http://i.imgur.com/xLWjmNb.png)

## Getting Started

To install Interact, run the following command in the Julia REPL:
```{.julia execute="false"}
Pkg.add("Interact")
```

**Note:** Interact only works with IPython/Jupyter version 3.0 or higher.

To start using it in an IJulia notebook, include it:
```{.julia execute="false"}
using Interact
```
[`GtkInteract`](https://github.com/jverzani/GtkInteract.jl) provides Gtk support for Interact, letting you use tools like `Winston` for plotting.

## Example notebooks

The best way to learn to use the interactive widgets is to try out the example notebooks in the doc/notebooks/ directory. Start up IJulia from doc/notebooks/:

```julia
using IJulia
notebook()
```

## Troubleshooting

### Jupyter/IPython version support

Interact needs IJulia to be running on Jupyter/IPython 3.x or Jupyter 4.x.
For Jupyter 4.x, the Python packages `jupyter` and `ipywidgets` must be installed.

### `ipywidgets` version

Interact relies on the `ipywidgets` python package which is an add-on to Jupyter that provides the widgets. The 5.x version of `ipywidgets` is installed by default by IJulia as of now. It might be the case that you have version 4.x of `ipywidgets` in which case you will need to use the `ipywidgets-4` branch of `Interact` due to backwards-incompatible changes. To do this, simply run `Pkg.checkout("Interact", "ipywidgets-4")`. You can run

```python
import ipywidgets
ipywidgets.__version__
```

in the python shell used by Jupyter to find out which version of ipywidgets you have. (Pkg.build("Interact") should also tell you which version of ipywidgets you have)