MurphyA/hacker-news huggingface dataset:
Show HN: Docc – AI-generated code walkthroughs with narration
by sandandcode | 2025-10-03 20:35:17+00:00
I built this tool that turns code repositories into interactive walkthroughs. You ask a question about a codebase, and it generates a video-like explanation using AI analysis + text-to-speech.

GitHub: https://github.com/RuliLG/docc

Background

Started this as my capstone project but the problem was real – I kept cloning repos and having no idea where to start. Reading docs doesn't answer specific questions, and asking ChatGPT about code it hasn't seen leads to hallucinations.

How it works

Points Claude Code CLI (or OpenCode) at your repository, gets it to analyze the actual code, then renders the response as an interactive player. Monaco editor shows the exact files and line numbers while explaining what's happening. You can enable TTS and literally listen to the walkthrough.

The AI response is structured JSON, so you get: - TL;DR summary - Relevant code blocks with specific line ranges - Explanatory markdown for each section

Tech stack

- Backend: FastAPI + Python - Frontend: React + Monaco editor - AI: Claude Code CLI / OpenCode CLI for repo analysis - TTS: ElevenLabs or OpenAI with caching - Runs in Docker

Current limitations

- It's a capstone project, so rough in places - Performance depends on repo size and AI provider - TTS caching helps but first runs can be slow

Looking for feedback on:

1. What questions do you most often ask about unfamiliar codebases? 2. Would you prefer this as a CLI tool vs web app? 3. Any AI providers you'd want supported?

The codebase is on GitHub, MIT licensed. Happy to answer questions about the implementation.
A FOSS project to create an Artificial Mind
by apiemotion | 2025-10-03 20:35:43+00:00
Self-Evolving AI System with Full Observability Built an autonomous AI platform that can discover and integrate new capabilities at runtime. Key technical points: Event-driven core: NATS message bus handles tool discovery, registration, and execution. System observes its own operations and adapts. Self-improvement loop: AI agents can create and deploy new tools/agents to extend system capabilities—"AI building AI" without human intervention. Full transparency: Real-time visibility into decision trees, reasoning chains, and inter-agent communication (rare in production AI systems). Production-ready stack: Docker isolation, Redis for state, K8s orchestration, REST APIs. News feeds trigger autonomous goal generation. The interesting bit: Unlike typical agent frameworks that are statically configured, this learns new domains by spinning up specialized sub-agents and tools dynamically. Zero-config onboarding of new capabilities. Trade-offs worth discussing: Event-driven complexity vs. debuggability, autonomous evolution vs. drift/instability, observability overhead at scale. Help welcome: https://github.com/stevef1uk/artificial_mind.git
by kelipso | 2025-10-03 20:36:54+00:00
What’s there to discuss any more?

There is data that some ridiculous percentage of academics are on the left, and drastically so for liberal arts departments.

“Everyone knows” that they filter against conservatives (maybe there isn’t hard data, but it’s pretty obvious to a lot of people, so I would say this is something that need to be disproven, not proven).

Liberals deny this, so what’s the point of discussing it. Let the dismantling continue until corrections happen I guess.
by taneq | 2025-10-03 20:37:28+00:00
"The Faroe Islands are like the child that Denmark and Iceland had, but forgot to tell the world about. This group of eighteen small islands receives the least amount of sunshine in the world per year. Constant rain and heavy winds have always battered these lands."

"Constant storms and crashing waves have sculpted the volcanic rock over millions of years into some of the most jaw-dropping (and vertigo-inducing) coastlines on Earth. These towering basalt cliffs can reach heights of over 400 meters, dropping straight into churning seas below."

OK, enough with the hard sell, what's the immigration policy?
by zahlman | 2025-10-03 20:37:43+00:00
It's been explained many times before why this is not possible: the library doesn't actually have a version number. The distribution of source code on PyPI has a version number, but the name of this is not connected to the name of any module or package you import in the source code. The distribution can validly define zero or more modules (packages are a subset of modules, represented using the same type in the Python type system).

You got three other responses before me all pointing at uv. They are all wrong, because uv did not introduce this functionality to the Python ecosystem. It is a standard defined by https://peps.python.org/pep-0723/, implemented by multiple other tools, notably pipx.
by pizzathyme | 2025-10-03 20:38:15+00:00
A sad realization I had:

- Well-run companies prioritize against a bell curve of core customers vs long tail customers

- Today, many of us are inside that curve. Products are made intuitive to us

- But many people (elderly) are not in the middle of that bell curve

And the kicker:

- One day, all of us will move out of that bell curve. Therefore, many products will suddenly become maddeningly frustrating to understand, at once

What's the solution? There's definitely a market opportunity for the long tail customers. But, it's tough to build a smartphone for a (relatively) smaller market. Maybe that's a startup opportunity
by alephnerd | 2025-10-03 20:38:19+00:00
> as other responder proposed, for me this will probably involve something on the softer side of the industry - design, product etc.

As a former SWE-turned-PM, you won't survive as a PM or Designer if this is the reason you became one. This is how bad PMs become PMs.

The PM and Designer market is very competitive, and PMs are expected to be domain experts of their entire market category and have engineering chops to not get BSed by engineers and have showmanship to successfully manage sales.

> I simply lack the time (and brain, maybe)

I'd try to find the time if possible. Maybe take a single course a semester to ramp up. Despite the negativity on HN, there is a lot of interesting innovation in the AI/ML world - both on the math/algos side as well as the infra/platform side.

Alternatively, as mentioned by others, really leverage your network and friendships to get jobs. It's a superpower you have as an old-timer in the industry - leverage it.
by hagbard_c | 2025-10-03 20:38:33+00:00
Wind and solar can not replace oil and gas without a working energy storage solution which is not feasible for many if not most countries except for those with suitable geography for hydroelectric storage. As it stands now every GW of solar/wind generating capacity needs to be combined with a similar GW of either nuclear or fossil capacity. Especially in the case of nuclear power it does not make sense to build generation capacity and not use it since it is in the planning and building phases that the largest investment lies. Once built a nuclear power plant should run at capacity to recuperate the costs of building and the coming costs of dismantling it. Fossil plants do have relatively high running costs so they are more suitable as backup solutions, especially quick-started gas turbine installations running on natural gas. Of course these power plants need a fuel source which ties their use to all the geopolitical politicking around supply sources, emissions and supposed 'climate impact'.

One good solution would be for wind and solar and other renewable power to be used for the creation of an easily storable fuel which can be used in e.g. gas turbines.
by pseudalopex | 2025-10-03 20:39:20+00:00
> Get out of here Ars

Please don't post insinuations about astroturfing, shilling, brigading, foreign agents, and the like. It degrades discussion and is usually mistaken. If you're worried about abuse, email hn@ycombinator.com and we'll look at the data.[1]

It looks mistaken in this case.

[1] https://news.ycombinator.com/newsguidelines.html
by clessed | 2025-10-03 20:39:45+00:00
I see the Supreme Court ruling as striking just about the right balance in law. It affirms single-sex spaces as actually being single-sex, and confirms that both sex and "gender reassignment" are protected characteristics in the Equality Act. So sex-based rights are upheld and at the same time there are protections against discrimination for the trans-identified.

As an example of how this should work going forward: a male work colleague who decides to start calling himself a woman and putting "she/her" in his email signature and so on can't be discriminated against because of this, which is fair. But also his female colleagues can be assured he has no right to start barging in on the women's toilets or changing rooms, which is also fair.

Back on the topic of boycotting Netflix, I personally think it's an overreaction. The whole gender identity ideological system sits somewhere between ludicrous and sexist, depending on exactly which beliefs someone takes from it, but there's loads of other shows on Netflix that are also ludicrous and also sexist. I feel it's an opportunity for critique of these ideas, rather than a blanket boycott of the whole platform.

That said, I wouldn't want my child to start believing this nonsense when she gets older but it feels like a fad that's on its way out. I don't think it'll be a problem. I'm more concerned about all the other misogynistic messaging that shows no sign of disappearing any time soon.
by Morizero | 2025-10-03 20:39:47+00:00
> without a dictator

I don't know what kind of pro-authoritarian sane-washing statement you're trying to make with this line. Jobs himself would tell you that it's a consequence of letting a salesperson run the company rather than a product person.

https://m.youtube.com/watch?v=K1WrHH-WtaA
by f311a | 2025-10-03 20:40:22+00:00
I was talking about syntax. I'm pretty sure there will be new features that will require a new keyword or syntax given the speed of Python growth. It can be universal, for example same as decorator, but it can be applied anywhere.

from lazy import make_lazy from package import module @make_lazy @local @nogil

Let's say this syntax gets introduced in Python 3.16. The @nogil feature can be introduced in 3.17. If such code is running in Python 3.16, the @nogil marker will be ignored.

The problem with new keywords is that you have to stick to the newest Python version every time a new keyword is added. Older Python versions will give a syntax error. It's a big problem for libraries. You need to wait for 3-5 years before adding it to a library. There are a lot of people who still use Python 3.8 from 2019.
by corimaith | 2025-10-03 20:40:42+00:00
>Weimar Germany collapsed due to the terms of Treaty of Versailles which essentially broke Germany's economy (Germany was essentially already in a depression well before the US).

This is completely wrong. Weimar Germany endured significant troubles in the early years due to political instability and reparations, but managed to overcome them with American loans and rewrite some terms for a decade or so of "Golden Years" before the Wall Street Crash, in which loans were withdrawn and the unemployment then rapidly rose.

So while the Treaty played a role, the Great Depression is the direct cause for Weimar Germany's eventual collapse. If they had 10 more years to recover, or if certain political moves were done differently, Fascism likely could have avoided.
by reissbaker | 2025-10-03 20:41:07+00:00
Yep — sadly the most effective cure is being on the receiving end of one of the stories, and realizing how bad faith they are.

I think the U.S. slander laws are probably too light. I'm generally supportive of the idea that "democracy dies in darkness," but I think we've gone further than that in allowing people to lie in public for money. I don't think that helps democracy, and in fact probably hurts it. I think anyone, anywhere on the political spectrum, can point to damning examples of the other side lying for their cause, and I think we'd all be better off if that stopped.
by gkoeka | 2025-10-03 20:41:23+00:00
SEEKING CLIENTS | Boulder, CO | Product Manage Your Business and Culture

I help leaders apply product management discipline not just to their product, but to their business and culture; the result: stronger teams, healthier systems, and customers who feel the impact.

That means: • Turning messy processes into clarity and alignment • Project leadership that balances delivery with adaptability • Coaching for teams and individuals to unlock potential • Building systems that scale sustainably (what got you here won’t always get you there)

My philosophy is simple: be good, do good, and build for success.

If your startup is growing rapidly and starting to feel the strain, I’m always open to discussing what’s worked in terms of product strategy, leadership, and cultural sustainability.

Website: https://www.gregkoeka.com/ LinkedIn: https://www.linkedin.com/in/gregkoeka/
by zahlman | 2025-10-03 20:41:37+00:00
You can implement this from your tool today: https://news.ycombinator.com/item?id=45467489

Note that this is global to the entire process, so for example if you make an import of Numpy lazy this way, then so are the imports of all the sub-modules. Meaning that large parts of Numpy might not be imported at all if they aren't needed, but pauses for importing individual modules might be distributed unpredictably across the runtime.

Edit: from further experimentation, it appears that if the source does something like `import foo.bar.baz` then `foo` and `foo.bar` will still be eagerly loaded, and only `foo.bar.baz` itself is deferred. This might be part of what the PEP meant by "mostly". But it might also be possible to improve my implementation to fix that.
by buu700 | 2025-10-03 20:41:37+00:00
I've seen things like that, but I haven't heard of any provider with a bidding mechanic for allocation of spare compute (like the EC2 spot market).

I could imagine scenarios where someone wants a relatively prompt response but is okay with waiting in exchange for a small discount and bids close to the standard rate, where someone wants an overnight response and bids even less, and where someone is okay with waiting much longer (e.g. a month) and bids whatever the minimum is (which could be $0, or some very small rate that matches the expected value from mining).
by randycupertino | 2025-10-03 20:41:46+00:00
Moody's analysts are already warning of a “Growth Recession” based on corporate credit strain.

> Moody's forecast model for recession, which has had zero false positives, now predicts 49% probability of recession.

> Every time that particular model gets over 50 (50%) we've had a recession. And we've never had a false positive. Never has it risen above 50, and we've not gotten a recession.

https://www.moodys.com/web/en/us/insights/podcasts/inside-ec...
by spiderxxxx | 2025-10-03 20:42:12+00:00
No, they gave the cannibal ants a link to a new food source. Imagine you're living in your house, your neighborhood, and there's this large pit in the center, where the cannibals live. They're 30ft down so they can't get out, so you don't have to worry. Then someone puts a ladder down to them. Start of a horror movie if you ask me.
by zzyzek | 2025-10-03 20:42:21+00:00
This is based off of Paul Merrell's Model Synthesis work [0]. Boris The Brave had a good writeup of the core of the algorithm [1].

Max Gumin focused on just the constraint solver and added a "minimum entropy heuristic", popularized the work and coined the term "wave function collapse", as the way the solver worked was evocative of (a naive view) of how quantum mechanics solves systems [2]. Gumin's repo also has many other resources of implementations and descriptions [3].

I've published a paper on an extension that adds in a type of backtracking to both the "WFC" portion of the solver and the modify in blocks portion of the solver, which can be found in [4], for those interested.

[0] https://paulmerrell.org/model-synthesis/

[1] https://www.boristhebrave.com/2021/10/26/model-synthesis-and...

[2] https://github.com/mxgmn/WaveFunctionCollapse

[3] https://github.com/mxgmn/WaveFunctionCollapse?tab=readme-ov-...

[4] https://zzyzek.github.io/PunchOutModelSynthesisPaper/
by FollowingTheDao | 2025-10-03 20:43:30+00:00
Yes, is the tiny 25 bp decrease in the Fed Rate we just had partially responsible for this sudden uptick in equities? If so I think it marks a kind of desperation. If there is no where else to invest, like tresuries, they push it in every other market you can.

Or, do they know the job report that did not come out this week is horrible and this is the insider pump before the dump? The Shiller price-to-earnings ratio has climbed to 40.08. Insanity like .com bubble.
by sodality2 | 2025-10-03 20:44:02+00:00
BBL Drizzy seems to me like a case where the cultural zeitgeist was more important than the actual additions made by AI. The lyrics were human - King Willonius admitted as much - so wasn't it just Udio AI reading them out + sampled backing track? Then Metro Boomin remixed the far more popular version by sampling bits and pieces, and I think that his contributions were 100% transformative. There's no way BBL DRIZZY BPM 150.mp3 could have been made by an AI any time soon
by arifalkner | 2025-10-03 20:44:58+00:00
Great talk! One thing that would have been nice to call out for n00bs like myself is how in SOP Futures can't cancelled. I knew that .await took ownership of the future so that drop() could not be called on it, so given how futures are lazy, it wasn't clear to me how to cancel a future after .await had been called. I later researched how select! and Abortable() did this, but could be nice to include a callout in the beginning of your talk if you ever do it again. Otherwise, nice work!
by bilbo0s | 2025-10-03 20:45:23+00:00
There are already attribution technologies that are reliable and definitive. There's no real technical reason that they wouldn't have the capability to directly attribute accounts.

Now..

is any of that gonna stop John or Joan Q Public who has a running disagreement with their asian or hispanic neighbor from calling in a "tip"? Probably not.

Will that tip result in an automated digital proctology exam that may land them, or people they may have been communicating with (like grandma), in ICE custody?

I'm thinking probably so.

The danger here is not really technology. The danger here is people. They are essentially automating the "snitch-to-detainment" pipeline.
by Arubis | 2025-10-03 20:45:32+00:00
You don't even need to take a job. You can just [dress up as ICE](https://www.cnn.com/2025/02/04/us/ice-impersonators-on-the-r...) and use the threat of deportation to assault them.

Or you could probably take the job and do that while getting paid. It's clear enough this admin would approve.
by ryukoposting | 2025-10-03 20:46:56+00:00
Thank you for the explanation! Between your explanation and a Youtube video I found of someone using it, I think have a grip on the "why" now. Interestingly, it seems like I might use i3 a little differently than you did. A single working context for me can span many desktops, and I just work in a way that keeps my number of concurrent working contexts low. I only ever have 1-2 programs on any given desktop, and even 2 is unusual. I keep every window in tabbed mode. When I need a scratch "thing" (nautilus, terminal, localc, whatever) it opens as a new tab. If I need it side-by-side with that desktop's primary window, I pop it out using mod4+shift+left/right. This accomplishes a similar thing to that Niri is getting you, just with different ergonomics. It probably helps that I have good habits around closing unused tabs / programs.
by jaredcwhite | 2025-10-03 20:47:12+00:00
You are doing exactly what happens repeatedly in these sorts of conversations. You completely ignore all subtext, all historical context, all conclusion, all metatextual reading in favor of exact out-of-context literal wordings which you claim will convince you of the case. That is not what will happen, but of course you know that already.

No xenophobic racist with an ounce of sense is going to write something like "brown people are rapist criminals who have invaded our lands and must be cleansed". It's absurd to maintain we must provide that as proof or it didn't happen.
by visarga | 2025-10-03 20:47:49+00:00
Richard makes a distinction between human understanding and AI indifference to truth. But isn't that what half the country is doing a.t.m? And more philosophically, we can't know the Truth because we rely on leaky abstractions all the way.

AI models are subject to user satisfaction and sustained usage, the models also have a need to justify their existence, not just us. They are not that "indifferent", after multiple iterations the external requirement becomes internalized goal. Cost is the key - it costs to live, and it costs to execute AI. Cost becomes valence.

I see it like a river - water carves the banks, and banks channel the water, you can't explain one without the other, in isolation. So are external constraints and internal goals.
by touisteur | 2025-10-03 20:47:58+00:00
There is limited chaining capability in io_uring that can be an actual gamechanger if your chain of ops can be fully in-kernel.

An intern of mine wrote a whole tcp-checkpoint-(pause-ingress-and-egress-and-the-socket-save-all-state-unpause-everything)-and-send-full-state-on-other-socket (which was a dozen or so ops - netlink writes, ioctls, set/getsockopt, read/write calls...) in a chain - all in one command-queue-write IIRC.

Performance was as good as an ad-hoc kernel module, without any ebpf. We just had one kernel patch to handle some unhandled syscall (getsockopt ? Setsockopt ? Ioctl?) (that we sadly didn't upstream... 2 years ago) and we were done. Really a great system for batching syscalls.

It made me wish for a form of DAG for error-handling or for parallel operations in chains...
by fuoqi | 2025-10-03 20:48:24+00:00
If it's an everything bubble, than it may not be a bubble, but a currency depreciation instead (not just $, but of all fiat currencies). Market participants openly expect a new round of bigger than ever money printing on the first serious signs of the R word (and BBB is just a precursor here).

Though, personally, I consider the AI trade to be currently deep in the overripe bubble territory.
by bikezen | 2025-10-03 20:49:55+00:00
Have you considered that it's not filtering for conservatives, but conservatives are self-selecting out or can't cut it at all? Isn't liberal arts degree a literal punchline to so many on the right, yet you cant figure out why that might skew left?

> maybe there isn’t hard data, but it’s pretty obvious to a lot of people, so I would say this is something that need to be disproven, not proven

Huh, wonder why this world view doesnt jive with academia.
by iLemming | 2025-10-03 20:50:03+00:00
I have done that for awesomewm https://github.com/agzam/awesomewm.d/blob/main/src/emacs.fnl

I'm not using it anymore though. I moved to Hyprland. I built my config in Clojure, but I need to fix a few things before making the repo public.
by shp013 | 2025-10-03 20:51:02+00:00
Product Manager (recent titles: Director, Sr.)

Location: New York, SF Bay Area, Southern California or Seattle preferred

Remote: Preferred, Yes worldwide possible (as either part time, fractional, consulting, board, advisory, freelance or similar arrangement)

Willing to relocate: Yes

Technologies: All of the standard PM tools, Mixpanel, Amplitude, Figma, SQL, Tableau, UI/UX design tools, AI/LLM tools, Git, AWS, Google Analytics, Adobe Creative Suite

Résumé/CV: available on request

Results-oriented Product Management and People Leader with 15+ years of experience in the Mobile, Internet and Fintech industries, known for driving innovation, high-impact growth, and strategic product direction. With a proven track record in scaling billion dollar products across global markets, leveraging expertise in AI/ML, UX/UI, and e-commerce to deliver user-centric solutions. Accomplished executive in leading organizations.

Email: shp012@proton.me