# Quickstart

[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mlco2/codecarbon/blob/master/docs/tutorials/first-tracking.ipynb)

In this tutorial, you'll track your first carbon emissions in under 5 minutes. By the end, you will have:

1. Installed CodeCarbon
2. Tracked emissions from a simple computation
3. Inspected the results

---

## Step 1: Install CodeCarbon

Let's start by installing the CodeCarbon package:

```console
pip install codecarbon
```

## Step 2: Track emissions from a computation

With CodeCarbon installed, we're ready to write our first tracking script. The simplest way to use CodeCarbon is as a **context manager**. Everything inside the `with` block is tracked.

```python
from codecarbon import EmissionsTracker

with EmissionsTracker(project_name="my-first-tracking") as tracker:
    # Simulate some computation
    total = 0
    for i in range(10_000_000):
        total += i

print(f"Computation result: {total}")
```

## Step 3: Inspect the results

Now that the tracker has run, let's look at what it recorded. CodeCarbon saves the emissions data to a CSV file called `emissions.csv`:


```python
import pandas as pd

df = pd.read_csv("emissions.csv")
df[["project_name", "duration", "emissions", "emissions_rate", "cpu_power", "ram_power", "energy_consumed"]]
```

You can also access the emissions data directly from the tracker object:


```python
print(f"Total emissions: {tracker.final_emissions * 1000:.4f} g CO2eq")
print(f"Duration: {tracker.final_emissions_data.duration:.2f} seconds")
print(f"Energy consumed: {tracker.final_emissions_data.energy_consumed:.6f} kWh")
```

## What's next?

- [Configure CodeCarbon](../how-to/configuration.md) with config files, environment variables, or script parameters
- Learn about [CLI tracking](cli.md) to monitor without code changes
- Explore all [Python API options](python-api.md) (decorators, explicit objects, offline mode)
- See the full [API Reference](../reference/api.md) for all configuration parameters
- Try the [CodeCarbon Workshop notebook](https://github.com/mlco2/codecarbon/blob/master/examples/notebooks/codecarbon_workshop.ipynb) for a comprehensive hands-on experience

## Need help?

Have questions about tracking, want to share your results, or contribute to CodeCarbon? **[Join our Discord community](https://discord.gg/GS9js2XkJR)** – we're here to help!