Quickstart

Install

pip install sense-lang

Requires Python 3.10+. This installs the sense command along with the interpreter itself — no other runtime dependency.

Run a file

Create hello.sns:

hello.sns

print("hello, sense")

Run it:

sense run hello.sns

hello, sense

Try the REPL

sense repl
# or just: sense

Sense 0.20.0 — interactive REPL ('exit' to quit)
sense> x = 5
sense> print(x * 2)
10
sense> exit

Typing sense with no arguments does the same thing — the same convenience bare python has (sense --help still lists every subcommand).

Sense blocks are indentation, like Python’s — the REPL keeps prompting with ... while a block (anything ending in :) is open, and a blank line ends it. See CLI Reference for the full behavior.

A slightly bigger example

fib.sns

def fib(n) -> Int:
    if n < 2:
        return n
    return fib(n - 1) + fib(n - 2)

i = 0
while i < 10:
    print(fib(i))
    i = i + 1

sense run fib.sns

The AI-native part

Everything above is Sense’s deterministic core — no different in spirit from Python. Here’s the part that isn’t: ask(), running entirely offline against a mock model so this needs no API key.

reason_demo.sns

model reasoning = inference("mock", "demo", response_template: "I think: {prompt}")
set delegation = reasoning

result = ask("what database should we use?")

print(result.value)        # the model's answer
print(result.confidence)   # how sure it was, as a plain readable number

sense run reason_demo.sns

I think: what database should we use?
0.5

result is an Answer, not a plain string — accessing .value is mandatory, so there’s never a moment where AI-generated output silently looks identical to a fact your code computed itself. See Model, Ask & Answer for the full picture, including how to scope which model is active with session.

Tutorials

Three short, hands-on walkthroughs — start with “Ask a Model.”

Which keyword do I want?

def vs tool vs action vs agent — a one-glance decision guide.

Language guide

Values, scoping, functions, control flow, modules.

Actions & policy

How Sense makes world-changing operations safe by construction.

Start here

Install

Run a file

Try the REPL

A slightly bigger example

The AI-native part

Next

Tutorials

Which keyword do I want?

Language guide

Actions & policy

​Install

​Run a file

​Try the REPL

​A slightly bigger example

​The AI-native part

​Next

Tutorials

Which keyword do I want?

Language guide

Actions & policy

Install

Run a file

Try the REPL

A slightly bigger example

The AI-native part

Next