Introduction

When people write sys.argv1, they usually mean sys.argv[1]. That bracketed version is the real Python syntax, and it refers to the second command-line argument passed to a script. To understand it properly, you need to know what sys.argv is, why it is a list, and how Python fills it in when your program starts.

What sys.argv Is

sys.argv is a list of strings provided by Python’s sys module.

import sys

print(sys.argv)

If you run:

python demo.py hello world

then sys.argv will typically look like:

['demo.py', 'hello', 'world']

So:

• 'sys.argv[0] is usually the script name'
• 'sys.argv[1] is the first argument after the script name'
• 'sys.argv[2] is the next argument'

That is what people usually mean when they ask about sys.argv[1].

Where It Comes From

It comes from the command line that launched the Python interpreter. Your operating system passes command-line arguments to the running process, and Python exposes them through sys.argv.

That is why sys.argv changes depending on how you start the script:

python demo.py report.txt
python demo.py input.csv output.csv

Different command lines produce different sys.argv contents.

You do not create sys.argv yourself. Python builds it during startup.

sys.argv[1] Means "First User Argument"

Example:

1import sys
2
3print("Script name:", sys.argv[0])
4print("First argument:", sys.argv[1])

If you run:

python greet.py Alice

the output is typically:

Script name: greet.py
First argument: Alice

So sys.argv[1] is not a special variable by itself. It is just list indexing.

Why sys.argv1 Is Wrong

This is invalid:

sys.argv1

Python interprets that as an attribute or variable name, not as "element 1 of sys.argv."

The correct syntax is:

sys.argv[1]

The square brackets are essential because sys.argv is a list.

Watch Out for Missing Arguments

If the user does not provide enough arguments, indexing can fail.

1import sys
2
3if len(sys.argv) > 1:
4    print(sys.argv[1])
5else:
6    print("No argument provided")

Without the length check, running the script with no extra arguments raises:

IndexError: list index out of range

That is one of the most common beginner errors with command-line parsing.

All Values Are Strings

Another important detail is that command-line arguments arrive as strings.

1import sys
2
3value = sys.argv[1]
4number = int(value)
5print(number + 5)

If you pass 10, Python receives '10', not the integer 10. You convert it yourself when needed.

Use argparse for Real Programs

sys.argv is fine for small scripts, but larger programs should usually use argparse.

1import argparse
2
3parser = argparse.ArgumentParser()
4parser.add_argument("name")
5args = parser.parse_args()
6
7print(f"Hello, {args.name}")

This gives you clearer help messages, named arguments, defaults, and validation. sys.argv is still the underlying raw source, but argparse is a better interface for serious command-line tools.

Common Pitfalls

The most common mistake is writing sys.argv1 instead of sys.argv[1].

Another issue is forgetting that sys.argv[0] is usually the script name, not the first user-supplied argument.

Many beginners also forget that arguments are strings and try to use them as numbers immediately.

Finally, always guard against missing arguments before indexing into the list, or your script can crash with IndexError.

Summary

• 'sys.argv is a list of command-line arguments provided by Python.'
• 'sys.argv[1] means the first user-supplied argument after the script name.'
• 'sys.argv1 is not valid Python syntax.'
• The values in sys.argv are strings, so convert them when needed.
• For real command-line tools, prefer argparse over manual sys.argv handling.