anything that can make the whole documentation about offline PyScirpt shrink to a single link would do to me :-)

yes I'm well aware of it and I used it and still had a battle, again a release bundle of the files to avoid having to install npm, emscripten and all their depends and also trying to figure out why if there is a local copy of an interpreter doesn't work the release bundle could be just dropped onto the server and it just works.
I do think something like this should be done as I would rather of spent the hour on that working on the pyscripting side instead

@brettowe Aha, I think I see more clearly what you're asking for. So just to be very clear (I want to make sure I capture exactly what you're asking for here):

• You want to use an "offline" version of PyScript that doesn't require a network connection.
• You don't want to go through all the manual build steps to generate your "offline" versions of things like Pyodide or MicroPython.
• Rather, you just want to be able to download a relocatable / copy-able directory containing all the pre-built static assets you need.
• You'll add, to a clearly signposted place, your own PyScript app code.
• Hurrah 🎉, you have a relocatable offline first PyScript app.

Right?

If you can confirm this, I'll create a ticket and (hopefully) write a script such that, as part of our release process, we generate a .zip or .tgz of such a relocatable thing, referenced in our release page and in our docs.

Sound like a plan? Please feel free to add more details, suggestions, constructive critique etc...

correct that is exactly what I am aiming for.
I'll note to save you some time when I edited the source that uses some CDN for pyodide and replaced it with at first /pyodide/pyodide.mjs it had issues due to modules needing ./ at minimum to function so i used ./pyodide/pyodide.mjs then it first pulls it from the directory pyscript exists in pyscript/pyodide/pyodide.mjs then after that it also pulls from pyscript/pyodide I ended up using symlinks to avoid duplication on disk
I did try micropython at one point but gave up and returned to pyodide so i'm not sure if it deals with same issue(s?).
in my case I was aiming for relative paths as pyscript and the script i was trying to use was not in the root path of the server and I did want to allow for juggling files around without having to edit things everytime

@brettowe I'll have a think about this. As far as I can tell, there's no reason why we can't make this work. I believe it's a very useful feature so bear with us while we figure something out. Here's the ticket with a more detailed description of the features and expected outcome that we're using to track this work: #2408

thanks for looking into it.
no rush on my part since I have a working setup for now of course, I'll just be really lazy about updates is all.

as much as we welcome users' contribution, we don't welcome useless or off-topic bot-generated content ... this is a warning, we'll find ourselves forced to ban your account if unrelated content will keep flowing through this space:

• we are a very tiny team with already tons of things to do and care about
• free distraction or moderation costs time, attention, and patience
• nothing in here would help anyone around this project

confident you can understand what I am writing and sure you'll read personally what this content brings in to our project, which is nothing, please do not let your tools produce this kind of unnecessary uselessness, thank you.

Sorry, no harm intended.

But warning are hardly needed,

I'll stop my efforts to contribute.

@Josverl hey hey.... just to be clear, please DO keep contributing. Just please make sure it contains good ol'fashioned organic human generated code 🤗, and not something purely AI generated 🤖.

That's not to say you shouldn't use an AI. Rather, for what I hope are obvious reasons (but happy to explore further, just ping me), we are necessarily wary of stuff that's obviously just AI sourced (and to your credit you were very clear this snippet was AI sourced).

So, to re-iterate, contributions: YES ✔️ 🤗 , AI generated content: that depends and we'll have our coding-defensive shields set to max 🛡️ 🤖 🤔 😉 .

For what it's worth, I use AI coding tools every day, but not for writing code. So I do understand how useful they can be for exploring a problem space.

I hope this helps?

@Josverl what @ntoll said ... that comment was entirely Rust based and out of context to me or this discussion topic so while I do welcome your contribution, that means you and not your agents that didn't do a great job in there (imho).

If you also do use agents a lot I hope you also do review the content these generate before filing PRs or the sentiment will be similar if there is a lot of review asked but not much effort from the PR filing side and I trust you that won't be the case.

Again, apologies for the slightly harsh reply but honestly, I've felt like I've wasted time reading all of that stuff when the topic here was very different and it will require zero Rust to move forward.

if i download offline.zip from https://github.com/pyscript/pyscript/releases it will only be offline.zip without any version info attached so the version in the full url path whatever url your referring to doesn't mean much since its not attached to the file and that indirect metadata is lost

yeah, I know, mine was about sharing links to the specific version ... I don't have a strong opinion here around the file name but we cannot create pre-release a release-versioned number as release happens when release happens ... or better, I need to wait for @ntoll thoughts around this as during release it is possible to change that name either via env variable while bundling (so that the unzipped archive also has that name) but it becomes more awkward for ourselves while testing ... although it's doable somehow.

Hey folks, thanks for this exploration. I think it would be useful if the name of the zip file itself included the release name. This could be "massaged" during the GH action we use for release, so instead of just offline.zip you'd get offline.2025.11.2.zip as the asset attached to the release and in the pyscript.net/releases/2025.11.2 page. Lemme take a look and get my YAML goggles on. :-)

I don't think the contents of the zip should change since the name of the archive (with the release number) is, I believe, sufficiently clear about what is contained therein.

See: #2413 for this fix.