Skip to content

Update README.md to use uv as method to install mewnala#110

Open
catilac wants to merge 1 commit intoprocessing:mainfrom
catilac:uv_instructions
Open

Update README.md to use uv as method to install mewnala#110
catilac wants to merge 1 commit intoprocessing:mainfrom
catilac:uv_instructions

Conversation

@catilac
Copy link
Copy Markdown
Contributor

@catilac catilac commented Apr 8, 2026

After feedback, updating the README.md to suggest uv for installing mewnala and running sketches

@catilac catilac requested review from SableRaf and tychedelia April 8, 2026 22:02
@catilac
Copy link
Copy Markdown
Contributor Author

catilac commented Apr 8, 2026

@SableRaf i've added you as an optional reviewer here. but if you happen to have time, you can try out the instructions and see if that makes your life easier. but note that i haven't added instructions for getting an example sketch just yet.

Copy link
Copy Markdown
Member

@tychedelia tychedelia left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🍄😻

@SableRaf
Copy link
Copy Markdown

SableRaf commented Apr 9, 2026

Thanks for tagging me @catilac

I’ll follow the instructions and share my experience while trying to adopt a beginner’s perspective, and with only minimal troubleshooting of my own.

I was able to successfully run

curl -LsSf https://astral.sh/uv/install.sh | sh

but at the end I got this warning which I did not understand:

WARN: The following commands are shadowed by other commands in your PATH: uv uvx

The next steps went smoothly except for the last one

uv run sketch.py

error: Failed to spawn: `sketch.py`
  Caused by: No such file or directory (os error 2)

Note: at this point, if I didn't know about ls I'd be stuck.

I noticed that the directory contains a hello.py, so I tried:

uv run hello.py

This printed:

Hello from mewnala-sketchbook!

Note: at this point, if I didn't know about nano I'd be stuck.

The content of hello.py doesn’t seem like a libprocessing/mewnala sketch, which looks a bit scary:

def main():
    print("Hello from mewnala-sketchbook!")


if __name__ == "__main__":
    main()

At this point, I’m not sure what the expected next step is.

Suggestions:

  • Add a short explanation of what each step does and the expected outcome so beginners can verify they’re on track.
  • Replace hello.py with sketch.py with mewnala syntax in the default sketchbook.
  • Add instructions on getting started with your first sketch.
  • Assume not everyone is comfortable with the command line
  • Get these instructions tested by real beginners (unguided/unmoderated to avoid bias)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants