The V Programming Language 0.5

Simple, fast, safe, compiled. For developing maintainable software

Ultra fast compilation speed

V compiles ≈100k LOC (Clang backend) and ≈700k LOC (arm64 and tcc backends) per second.
(Apple M5, no optimization)

V is written in V and compiles itself in 0.5 seconds on M5.

Try it yourself:

wget https://github.com/vlang/v/releases/latest/download/v_linux.zip
unzip v_linux && cd v
time ./v self
fn main() {
    areas := ['game', 'web', 'tools', 'science', 'systems',
              'embedded', 'drivers', 'GUI', 'mobile']
    for area in areas {
        println('Hello, ${area} developers!')
    }
}
Install V from source
git clone --depth=1 https://github.com/vlang/v
cd v
make
On Windows, run make.bat instead of make.
Then try ./v run examples/hello_world.v.

More Features

Simple language for building maintainable programs

You can learn the entire language by going through the documentation over a weekend, and in most cases there's only one way to do something.

This results in simple, readable, and maintainable code.

Despite being simple, V gives a lot of power to the developer and can be used in pretty much every field, including systems programming, webdev, gamedev, GUI, mobile, science, embedded, tooling, etc.

V is very similar to Go. If you know Go, you already know ≈80% of V. Things V improves on Go: vlang.io/compare#go.

Safety

Performance & Fast compilation

Performance

  • C interop without any costs
  • Minimal amount of allocations
  • Built-in serialization without runtime reflection
  • Compiles to native binaries without any dependencies: a simple web server is only about 250 KB
  • As fast as C (V's main backend compiles to human readable C), with equivalent code.
    V does introduce some overhead for safety (such as array bounds checking, GC free), but these features can be disabled/bypassed when performance is more important.

Small and easy to build compiler

V can be bootstrapped in under a second by compiling its code translated to C with a simple

cc v.c
No libraries or dependencies needed.

For comparison, space and time required to build each compiler:

Space   Build time
Go 525 MB 1m 33s
Rust 30 GB 45m
GCC 8 GB 50m
Clang 90 GB [0] 60m
Swift 70 GB [1] 90m
V < 20 MB [2] <1s

Flexible memory management

Flexible memory management

V avoids doing unnecessary allocations in the first place by using value types, string buffers, promoting a simple abstraction-free code style.

There are 4 ways to manage memory in V.

The default is a minimal and a well performing tracing GC.

The second way is autofree, it can be enabled with -autofree. It takes care of most objects (~90-100%): the compiler inserts necessary free calls automatically during compilation. Remaining small percentage of objects is freed via GC. The developer doesn't need to change anything in their code. "It just works", like in Python, Go, or Java, except there's no heavy GC tracing everything or expensive RC for each object. Autofree is still experimental and not production ready yet. That's planned for V 1.0.

For developers willing to have more low level control, memory can be managed manually with -gc none.

Arena allocation is available via v -prealloc.

V's autofree demo. All objects are freed during compilation. Running the Ved editor on an 8 MB file with 0 leaks:

Youtube Compile Speed

A powerful graphics library

A powerful graphics library

Cross-platform drawing library gg, using OpenGL/Metal/DirectX 11 for rendering 2D applications.

There's also a 3D engine in development with the following features already available:

  • Loading complex 3D objects with textures
  • Camera (moving, looking around)
  • Skeletal animation

A simple example of the graphics library in action is tetris.v.

For 3D examples, check out this.

Engine Screenshot

Painless deployments and dependency management & Run everywhere

Painless deployments and dependency management

To build your project, no matter how big, all you need to do is run

v .

No build environments, makefiles, headers, virtual environments, etc.

You get a single binary that is guaranteed to work on all operating systems (provided you cross compile) without any external dependencies.

This binary is self-contained except for the OS-provided system library (libc), which is linked dynamically.

To achieve fully static binaries on Linux, you can use v -cc musl-gcc .

Installing new libraries via vpm, a centralized package manager written in V, is as simple as
v install ui
		

Run everywhere

V can emit (human readable) C, so you get the great platform support and optimization of GCC and Clang. (Use v -prod . to make optimized builds.)

Emitting C will always be an option, even after direct machine code generation matures.

V can call C code, and calling V code is possible in any language that has C interop.

REPL & Cross-platform shell scripts in V

REPL

v
>>> import net.http
>>> data := http.get('https://vlang.io/utc_now')!
>>> data.body
1565977541

Cross-platform shell scripts in V

V can be used as an alternative to Bash to write deployment scripts, build scripts, etc. The advantage of using V for this is the simplicity and predictability of the language, and cross-platform support. "V scripts" run on Unix-like systems as well as on Windows.

for file in ls('build/') {
  rm(file)
}
mv('v.exe', 'build/')

v run deploy.vsh

Read more about V script

Code formatting with vfmt for consistent style & A built-in code profiler

Code formatting with vfmt for consistent style

No more arguments about coding styles. There's one official coding style enforced by the vfmt formatter.

All V code bases are guaranteed to use the same style, making it easier to read and change code written by other developers.

v fmt -w hello.v

A built-in code profiler

Build and run your program with

v -profile profile.txt x.v && ./x
and you'll get a detailed list for all function calls: number of calls, average time per call, total time per call.

JavaScript and WASM backends & Automatic documentation

JavaScript and WASM backends

V programs can be translated to JavaScript (WIP):

v -o hello.js hello.v

The JS backend is at an early stage.

They can also be compiled to WASM (for now with Emscripten, but native WASM support is planned). V compiler compiled to WASM and running V programs by translating them to JavaScript:

v-wasm.vercel.app

A game written using V's graphical backend and compiled to WASM:

v2048

Automatic documentation

Use vdoc to get instant documentation generated directly from the module's source code. No need to keep and update separate documentation.

v doc os

Built-in testing framework & Friendly error messages

Built-in testing framework

Writing tests is very easy: just start your test function with test_

fn get_string() string { return 'hello' }

fn test_get_string() {
  assert get_string() == 'hello'
}
      

Friendly error messages

Helpful error messages make learning the language and fixing errors simpler:

user.v:8:14: error: `update_user` parameter `user` is mutable, you need to provide `mut`: `update_user(mut user)`

    7 |     mut user := User{}
    8 |     update_user(user)
      |                 ~~~~
    9 | }
	

Powerful built-in web framework Veb

Powerful built-in web framework Veb

Veb is very fast (built on top of pico.v which has been at the top of TechEmpower benchmark), it compiles into a single binary (html templates are also compiled), supports hot code reloading (the website is automatically updated in the browser once you change any .v/.html file).

github.com/vlang/v/tree/master/vlib/veb

['/post/:id']
fn (b &Blog) show_post(id int) veb.Result {
  post := b.posts_repo.retrieve(id) or {
    return veb.not_found()
  }
  return veb.view(post)
}

Gitly, a light and fast alternative to GitHub/GitLab is built in V and Veb.

85933714-B195Fe80-B8Da-11Ea-9Ddd-09Cadc2103E4

Built-in ORM

Built-in ORM

import db.sqlite

struct Customer {
  id int
  name string
  nr_orders int
  country string
}

fn main() {
  db := sqlite.connect('example.sqlite') or {
    panic('could not create/find example.sqlite')
  }

  nr_customers := sql db {
    select count from Customer
  }!
  println('number of customers: ${nr_customers}')

  // V syntax can be used to build queries
  uk_customers := sql db {
    select from Customer where country == 'uk' && nr_orders > 0
  }!

  for customer in uk_customers {
    println('${customer.id} - ${customer.name}')
  }

  // by adding `limit 1` we tell V that there will be
  // only one object
  customer := sql db {
    select from Customer where id == 1 limit 1
  }!
  println(customer.name)

  // insert a new customer
  new_customer := Customer{name: 'Bob', nr_orders: 10}
  sql db {
    insert new_customer into Customer
  }!
}

From idea to something real

Built with V.

Explore the ecosystem ↗

The V Compiler

V itself is written in V.

Volt

Native desktop client for Slack, Skype, Matrix, Telegram, Twitch and many more services.

Vinix

A minimalistic open-source OS that can already run Bash, GCC, V, g++, GTK3.

Ved

Open-source 1 MB editor with the performance of Sublime Text.

Vox Browser

An early stage HTML+CSS renderer which can already render sites like Hacker News 20x faster than Chrome while using 4x less RAM.

Volt.im instant messaging and social platform

An upcoming open source alternative to Discord and Telegram that combines the best features of the two while being ultra fast and light.

vsql

A single-file SQL database written in pure V with no dependencies.

coreutils in V

Programs equivalent to GNU coreutils, written 100% in V.

C to V translator

This tool can already translate entire original DOOM. C++ support is planned as well. It does full automatic conversion to human readable code.

V UI

Cross-platform widget toolkit.

Gitly

Open-source light and fast alternative to GitHub/GitLab.

Gitly screenshot

Vorum

Right now it's very basic forum/blogging software, but in the future it will be a full featured light alternative to Discourse.
The V forum runs on Vorum.

vgram

A bot library for Telegram Bot API.

Awesome V

A curated list of awesome V frameworks, libraries and software

The V Tensor Library

An n-dimensional Tensor data structure, sophisticated reduction, elementwise, and accumulation operations, data Structures that can easily be passed to C libraries, powerful linear algebra routines backed by VSL.

The V Scientific Library

A Scientific Library with a great variety of different modules.

Lilly

A VIM-Like editor for your terminal

Lilly screenshot

V GUI

An immediate mode UI framework for V.

V GUI screenshot

Are you using V to build your product or library? Have it added to this list.

The latest from V

Always moving forward.

Latest news & blog posts / V 1.0 roadmap

June 9, 2022
As of today, programs built with the V compiler no longer leak memory by default.
May 29, 2022
7000 pull requests have been merged!

Made for people who love to build

In good company.

What developers say about V

I just stumbled into V the other day, and I've been working on a couple of personal projects. I'm really loving it so far. I spent a lot of time with Go, so it feels super familiar. That said, I actually have a module I made last night for interacting with MeshCore. I've not had this much fun programming in a long while.
CptnDuras
The V development team does an amazing job. I've never seen a language evolve that fast; I suspect you guys never sleep. I hope V will remain a simple, clean language and have a bright future. Thanks for all your hard work.
BrunoVDR
I like V a lot. The abstraction over the syntax is so nice that made me enjoy writing the syntax as a whole. V has come a lot further than when I tried it in 2023. I’ll be actively using it from now on.
Kris Tun
I'm mostly surprised by how many things "just work". Channels and closures made implementing asynchronous callbacks for C functions such a breeze. Thanks for that! 😄
Joel L.
V is the most comfortable syntax I've encountered, so I look forward to 1.0.
hellolio
Been programming for around 30 years. Have done some C/C++, VB, and lots of Delphi years ago. Then PHP/Ruby for over 15 years. Bash, Python too. Recently I've wanted to start using a compiled language for reasons, and have looked at Rust, Go, and a couple others. I stumbled upon V a few weeks ago and have been very surprised by how easy it is to pick up. I am really enjoying writing V and feel like I am already productive. Even to the point I'm now looking at making a small ...
FlibbyJibbit
Really like the direction of V, been wondering when this kind of language would pop up.
pbarker
V is amazing. Things I like about it:
  • Flexibility for operator overloading. (it makes syntax intuitive)
  • Compiles directly to C, and I love C
  • Flexibility for having and not having garbage collection
  • Go concurrency model
I come from a strong Java and Go background and have been playing with Rust. V looks pretty amazing in terms of readability.
Hoss
I buy my son's diaper with C#, but every project I start today is in V. Because every project in C# has an initial load of bureaucracy that in V I don't have to deal with at the beginning, and I can plug bureaucracy into the project throughout the creation process.
André L.
It's so much damn fun to program in it!
mrw
Gotta say that V's syntax is amazing (especially the error handling aspect for me since I strongly dislike Go's error handling approach but liked its other aspects).
Teddy
After V, developing a kernel in C results in more bugs, honestly more so because V catches a set of bugs and memory leakage that C simply doesn't.

mint, maintainer of Vinix
Just want to say thank you for continuing to improve the language. Adding the GC was very nice and I find V my all-time favorite language. Using V is fun due to great syntax and tooling but also makes you a better developer as you try to understand how things work underneath.
laotzu
Just wanted to say thank you to everyone contributing to V! Before September 2023 I never really coded nor completed any project as the tools I had were less than ideal. In September I started learning V and now I have a really good prototype and a professional developer even reached out to me saying my code was really good! That's why I wanted to thank V and all the contributors 🥰
Sh.a D'eau
It's obvious that Alex was able to bring his experience of many other languages to V, giving the language a very solid foundation. It's difficult for me to list all the positive qualities I like about V because I'm sure I'll forget some. I'll try it anyway.
  • compilation speed
  • simplicity (only a few keywords), yet powerful
  • readability & maintainability
  • execution performance
  • cross compilation ...
Thanks to everyone who contributed to this project. The simplicity of language and the fact that it's compiled makes it number 1 where applicable.
TenTypekMatus
I think you do not get enough credit for the amazing language V is. Thank you for your time and effort.
mihaigalos
When I stumbled across V, it just 'felt right'.
chris_debian
Thank you very much to everyone contributing to V! It's been 1.5 years since I've discovered it. I really enjoy the kind and helping community, the simplicity philosophy and lots of other things. I was pleasantly surprised by the easiness of creating an HTTP server: just a few lines and then handling the request is very easy by following the example. A big thank you from the bottom of my heart ❤️
nopana
V is the better Go. I use V in production for my personal projects. It is such a joy to use.
dovh49
When I stumbled across V, it just 'felt right'.
chris_debian
I mastered Python when I worked as a Data Scientist a few years ago. Since I discovered V I stopped using Python almost entirely, and now I look back and... it's awful. Never had so much fun programming as I am now.
rodabt
V is seriously impressive. After years of Go development, V brings the simplicity I love, but with true low-level control and raw speed — exactly what I’ve been missing. Looking forward digging deeper with this tech, just started ❤️
BadassBrah

You’re in good company

A language. A community.

Join us on Discord ↗

Find your people.

Ask a question, share what you’re building, or help shape what comes next.

Your favorite editor, too.

Bring syntax highlighting and language tools to the place you already call home.