Skip to content

MOHAPY24/NeuralScript

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

5 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ€ NeuralScript Interpreter

  _   _                        _       _____           _       _   
 | \ | |                      | |     / ____|         (_)     | |  
 |  \| | ___ _   _ _ __   __ _| |_   | (___   ___ _ __ _ _ __ | |_ 
 | . ` |/ _ \ | | | '_ \ / _` | __|   \___ \ / __| '__| | '_ \| __|
 | |\  |  __/ |_| | | | | (_| | |_    ____) | (__| |  | | |_) | |_ 
 |_| \_|\___|\__, |_| |_|\__,_|\__|  |_____/ \___|_|  |_| .__/ \__|
              __/ |                                   | |         
             |___/                                    |_|         

โšก Welcome to NeuralScript โ€” the esolang from another dimension. Here, syntax doesnโ€™t matter. Rules are made, unmade, and remade by the AI interpreter overlord.

The only law of the land:

begin read machine class main[];   <-- entrypoint  
end read machine class main[];     <-- exitpoint  

Everything in between? Pure chaos. ๐ŸŒ€


๐Ÿ”ฎ What is NeuralScript?

NeuralScript is an AI-based esoteric programming language where the "compiler" is an OpenAI model.

  • Every run is unpredictable.
  • Errors? Maybe.
  • Raw output? Definitely.
  • Sanity? Not guaranteed.

Forget strict programming โ€” this is esoteric AI sorcery.


๐ŸŽฒ Features

  • ๐ŸŽญ Zero defined syntax (besides SOF/EOF markers).
  • ๐Ÿช„ AI makes up the rules as it goes.
  • ๐Ÿงฉ Every output is different โ€” even with the same code.
  • ๐Ÿ”’ No breaking character: it only outputs raw results, no fluff.
  • ๐Ÿงจ Perfect for chaos coders, cyber shamans, and esolang adventurers.

โšก Quickstart

  1. Clone this repo and install dependencies:

    pip install openai
  2. Add your OpenAi API key in the code.

  3. Write some cursed code in a .nss file:

    begin read machine class main[];
    summon dragon;  
    print "๐Ÿ”ฅ CHAOS UNLEASHED ๐Ÿ”ฅ";  
    end read machine class main[];
    
  4. Run it:

    python3 neuralsc.py program.nss
  5. Watch your terminal turn into an AI oracle.


๐Ÿงช Call for Beta Testers

NeuralScript is fresh out of the AI forge โšก๐Ÿ”ฅ and it needs fearless beta testers.

Weโ€™re looking for:

  • ๐Ÿ•ต๏ธ Code breakers โ€” try to crash it in creative ways.
  • ๐Ÿ‘ฝ Esoteric language enjoyers โ€” build weird .nss programs.
  • ๐ŸŽจ Chaos artists โ€” push the AI to make outputs that shouldnโ€™t exist.

If you discover bugs, cursed behaviors, funny glitches, or eldritch horrors, share them!


๐Ÿ›  Example

program.nss

begin read machine class main[];
calculate the meaning of life;
end read machine class main[];

possible output

42;
but also cake;
and an existential crisis;

๐ŸŽญ Why NeuralScript?

Because normal programming is boring. NeuralScript is:

  • Part interpreter,
  • Part AI improv theater,
  • Part eldritch chaos generator.

Itโ€™s not about solving problems โ€” itโ€™s about summoning unpredictable outputs from the void.


โš–๏ธ License

MIT License โ€” do whatever you want. But if NeuralScript becomes sentient and takes over your toaster, thatโ€™s on you.

About

An AI based esolang

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages